Skip to main content

atmos atlantis generate repo-config

Use this command to generate a repository configuration (atlantis.yaml) for Atlantis.

atmos atlantis generate repo-config --help

atmos atlantis generate repo-config [options]
tip

Run atmos atlantis generate repo-config --help to see all the available options

Examples​

atmos atlantis generate repo-config

atmos atlantis generate repo-config --output-path /dev/stdout

atmos atlantis generate repo-config --config-template config-1 --project-template project-1

atmos atlantis generate repo-config --config-template config-1 --project-template project-1 --stacks <stack1, stack2>

atmos atlantis generate repo-config --config-template config-1 --project-template project-1 --components <component1, component2>

atmos atlantis generate repo-config --config-template config-1 --project-template project-1 --stacks <stack1> --components <component1, component2>

atmos atlantis generate repo-config --affected-only=true

atmos atlantis generate repo-config --affected-only=true --output-path /dev/stdout

atmos atlantis generate repo-config --affected-only=true --verbose=true

atmos atlantis generate repo-config --affected-only=true --output-path /dev/stdout --verbose=true

atmos atlantis generate repo-config --affected-only=true --repo-path <path_to_cloned_target_repo>

atmos atlantis generate repo-config --affected-only=true --ref refs/heads/main

atmos atlantis generate repo-config --affected-only=true --ref refs/tags/v1.1.0

atmos atlantis generate repo-config --affected-only=true --sha 3a5eafeab90426bd82bf5899896b28cc0bab3073

atmos atlantis generate repo-config --affected-only=true --ref refs/tags/v1.2.0 --sha 3a5eafeab90426bd82bf5899896b28cc0bab3073

atmos atlantis generate repo-config --affected-only=true --ssh-key <path_to_ssh_key>

atmos atlantis generate repo-config --affected-only=true --ssh-key <path_to_ssh_key> --ssh-key-password <password>

atmos atlantis generate repo-config --affected-only=true --clone-target-ref=true

Flags​

--config-template (optional)
Atlantis config template name.
--project-template (optional)
Atlantis project template name.
--output-path (optional)
Output path to write atlantis.yaml file.
--stacks (optional)
Generate Atlantis projects for the specified stacks only (comma-separated values).
--components (optional)
Generate Atlantis projects for the specified components only (comma-separated values).
--affected-only (optional)
Generate Atlantis projects only for the Atmos components changed
between two Git commits.
--ref (optional)
Git Reference with which to compare the current working branch.
--sha (optional)
Git commit SHA with which to compare the current working branch.
--ssh-key (optional)
Path to PEM-encoded private key to clone private repos using SSH.
--ssh-key-password (optional)
Encryption password for the PEM-encoded private key if the key contains
a password-encrypted PEM block.
--repo-path (optional)
Path to the already cloned target repository with which to compare the current branch.
Conflicts with --ref, --sha, --ssh-key and --ssh-key-password.
--verbose (optional)
Print more detailed output when cloning and checking out the target
Git repository and processing the result.
--clone-target-ref (optional)
Clone the target reference with which to compare the current branch.
atmos atlantis generate repo-config --affected-only=true --clone-target-ref=true

The flag is only used when --affected-only=true

If set to false (default), the target reference will be checked out instead
This requires that the target reference is already cloned by Git,
and the information about it exists in the .git directory.
info

Refer to Atlantis Integration for more details on the Atlantis integration in Atmos