Add base_path setting to atmos config (#100)

* Updates

* Updates

* Add `base_path`

* Add `base_path`

* Add `base_path`

* Add `base_path`

* Add `atmos` logos

* Update README.yaml

Co-authored-by: Erik Osterman (CEO @ Cloud Posse) <erik@cloudposse.com>

* Update README.yaml

Co-authored-by: Erik Osterman (CEO @ Cloud Posse) <erik@cloudposse.com>

* Update README

* Update README

* Update README

Co-authored-by: Erik Osterman (CEO @ Cloud Posse) <erik@cloudposse.com>

README.md

@@ -28,7 +28,9 @@
 
 -->
 
-Universal Tool for DevOps and Cloud Automation.
+![atmos](docs/img/atmos-logo-128.svg)
+
+`atmos` - Universal Tool for DevOps and Cloud Automation.
 
 ---
 
@@ -92,23 +94,32 @@ Moreover, `atmos` is not only a command-line interface for managing clouds and c
 
 ### OSX
 
-From Homebrew directly
+From Homebrew directly:
 
 ```
 brew install atmos
 ```
 
-### cloudposse/packages
+### Linux
 
-On Debian, run:
+On Debian:
 
 ```
-apt install atmos@="<ATMOS_VERSION>-*"
+# Add the Cloud Posse package repository hosted by Cloudsmith
+apt-get update && apt-get install -y apt-utils curl
+curl -1sLf 'https://dl.cloudsmith.io/public/cloudposse/packages/cfg/setup/bash.deb.sh' | bash
+
+# Install atmos
+apt-get install atmos@="<ATMOS_VERSION>-*"
 ```
 
-On Alpine, run:
+On Alpine:
 
 ```
+# Install the Cloud Posse package repository hosted by Cloudsmith
+curl -sSL https://apk.cloudposse.com/install.sh | bash
+
+# Install atmos
 apk add atmos@cloudposse~=<ATMOS_VERSION>
 ```
 

README.yaml

@@ -2,6 +2,8 @@ name: atmos
 
 license: APACHE2
 
+logo: docs/img/atmos-logo-128.svg
+
 github_repo: cloudposse/atmos
 
 badges:
@@ -24,7 +26,9 @@ categories:
   - kubernetes
   - aws
 
-description: Universal Tool for DevOps and Cloud Automation.
+description: |-
+  
+  `atmos` - Universal Tool for DevOps and Cloud Automation.
 
 introduction: |-
 
@@ -61,26 +65,35 @@ introduction: |-
 
   ### OSX
 
-  From Homebrew directly
+  From Homebrew directly:
 
   ```
   brew install atmos
   ```
   
-  ### cloudposse/packages
+  ### Linux
+  
+  On Debian:
   
-  On Debian, run:
- 
   ```
-  apt install atmos@="<ATMOS_VERSION>-*"
+  # Add the Cloud Posse package repository hosted by Cloudsmith
+  apt-get update && apt-get install -y apt-utils curl
+  curl -1sLf 'https://dl.cloudsmith.io/public/cloudposse/packages/cfg/setup/bash.deb.sh' | bash
+  
+  # Install atmos
+  apt-get install atmos@="<ATMOS_VERSION>-*"
   ```
   
-  On Alpine, run:
- 
+  On Alpine:
+
   ```
+  # Install the Cloud Posse package repository hosted by Cloudsmith
+  curl -sSL https://apk.cloudposse.com/install.sh | bash
+  
+  # Install atmos
   apk add atmos@cloudposse~=<ATMOS_VERSION>
   ```
-
+ 
   ### Go
   
   Install the latest version
@@ -90,14 +103,14 @@ introduction: |-
   ```
   
   Get a specific version
- 
+  
   __NOTE:__ Since the version is passed in via `-ldflags` during build, when running `go install` without using `-ldflags`, 
   the CLI will return `0.0.1` when running `atmos version`.
 
   ```
   go install github.com/cloudposse/atmos@v1.3.9
   ```
- 
+  
   ## Build from source
   
   ```

atmos.yaml

@@ -8,11 +8,20 @@
 # It supports POSIX-style Globs for file names/paths (double-star `**` is supported)
 # https://en.wikipedia.org/wiki/Glob_(programming)
 
+# Base path for components and stacks configurations.
+# Can also be set using `ATMOS_BASE_PATH` ENV var, or `--base-path` command-line argument.
+# Supports both absolute and relative paths.
+# If not provided or is an empty string, `components.terraform.base_path`, `components.helmfile.base_path` and `stacks.base_path`
+# are independent settings (supporting both absolute and relative paths).
+# If `base_path` is provided, `components.terraform.base_path`, `components.helmfile.base_path` and `stacks.base_path`
+# are considered paths relative to `base_path`.
+base_path: "./examples/complete"
+
 components:
   terraform:
     # Can also be set using `ATMOS_COMPONENTS_TERRAFORM_BASE_PATH` ENV var, or `--terraform-dir` command-line argument
     # Supports both absolute and relative paths
-    base_path: "./examples/complete/components/terraform"
+    base_path: "components/terraform"
     # Can also be set using `ATMOS_COMPONENTS_TERRAFORM_APPLY_AUTO_APPROVE` ENV var
     apply_auto_approve: false
     # Can also be set using `ATMOS_COMPONENTS_TERRAFORM_DEPLOY_RUN_INIT` ENV var, or `--deploy-run-init` command-line argument
@@ -22,7 +31,7 @@ components:
   helmfile:
     # Can also be set using `ATMOS_COMPONENTS_HELMFILE_BASE_PATH` ENV var, or `--helmfile-dir` command-line argument
     # Supports both absolute and relative paths
-    base_path: "./examples/complete/components/helmfile"
+    base_path: "components/helmfile"
     # Can also be set using `ATMOS_COMPONENTS_HELMFILE_KUBECONFIG_PATH` ENV var
     kubeconfig_path: "/dev/shm"
     # Can also be set using `ATMOS_COMPONENTS_HELMFILE_HELM_AWS_PROFILE_PATTERN` ENV var
@@ -33,7 +42,7 @@ components:
 stacks:
   # Can also be set using `ATMOS_STACKS_BASE_PATH` ENV var, or `--config-dir` and `--stacks-dir` command-line arguments
   # Supports both absolute and relative paths
-  base_path: "./examples/complete/stacks"
+  base_path: "stacks"
   # Can also be set using `ATMOS_STACKS_INCLUDED_PATHS` ENV var (comma-separated values string)
   included_paths:
     - "**/*"