diff --git a/enos/enos-dev-scenario-pr-replication.hcl b/enos/enos-dev-scenario-pr-replication.hcl index 8f5039109489..75c302866e01 100644 --- a/enos/enos-dev-scenario-pr-replication.hcl +++ b/enos/enos-dev-scenario-pr-replication.hcl @@ -66,11 +66,10 @@ scenario "dev_pr_replication" { c. 'artifact:zip' This will download a Vault .zip bundle from releases.hashicorp.com with the version and edition you specify. - - TODO: add required variable - + 5. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command: + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list dev_single_cluster @@ -81,7 +80,7 @@ scenario "dev_pr_replication" { Notes: - To learn more about any Enos command, use the `--help` flag, e.g.: - + $ enos scenario launch --help - Enos will run all matrix variant combinations that match your filter. If you specify one @@ -108,94 +107,6 @@ scenario "dev_pr_replication" { 7. When you're done, destroy the scenario and associated infrastructure: $ enos scenario destroy dev_pr_replication - - - - - PREREQUISITES - - In order to execute this scenario you'll need: - - 1. To install the enos CLI: - - $ brew tap hashicorp/tap && brew update && brew install hashicorp/tap/enos - - 2. Authenticate to an AWS account via Doormat and export the credentials locally. Follow the guide here: - https://eng-handbook.hashicorp.services/internal-tools/enos/getting-started/#authenticate-to-aws-with-doormat - - 3. An SSH keypair set up in your AWS account: - https://eng-handbook.hashicorp.services/internal-tools/enos/getting-started/#set-your-aws-key-pair-name-and-private-key - - RUNNING THIS SCENARIO - - 1. Set input variables - - This scenario requires several input variables to be set in order to function - properly. While not all variants will require all variables, it's suggested that you look over - the scenario outline to determine which variables affect which steps and which have inputs that - you should set. You can use the following command to get a textual outline of the entire - scenario: - enos scenario outline dev_pr_replication - - You can also create an HTML version that is suitable for viewing in web browsers: - enos scenario outline dev_pr_replication --format html > index.html - open index.html - - There are two main options for setting these input variables: - - * Create an 'enos-local.vars' file in the same 'enos' directory where this scenario is defined. - Declare your desired variable values in this file. For example, you could copy the following content - and then set the values as necessary: - - (Note: Artifactory credentials are only required if you are using `artifact:deb` or `artifact:rpm`, - as Enos will download these from Artifactory) - artifactory_username = "username@hashicorp.com" - artifactory_token = " - aws_region = "us-west-2" - aws_ssh_keypair_name = "" - aws_ssh_keypair_key_path = "/path/to/your/private/key.pem" - dev_build_local_ui = false - dev_consul_version = "1.18.1" - vault_license_path = "./support/vault.hclic" - vault_product_version = "1.16.2" - - * Set them as environment variables: - - export ENOS_VAR_aws_region="us-west-2" - export ENOS_VAR_vault_license_path="./support/vault.hclic" - - 2. Launch the scenario - - After you've configured your inputs, you can list and filter the available scenarios and then - subsequently launch your desired one. - - Note: To learn more about any Enos command, use the `--help` flag, e.g.: - enos scenario launch --help - - If you don't know yet what combination of matrix variants you want to use for your scenario, - can view all the possible combinations through the `list` command: - enos scenario list dev_pr_replication - - - Once you know what filter you want to use to obtain your desired combination of matrix variants, - use the `launch` command with that filter to launch your scenario. - enos scenario launch dev_pr_replication arch:amd64 artifact:deb distro:ubuntu edition:ent.hsm primary_backend:raft primary_seal:awskms secondary_backend:raft secondary_seal:pkcs11 - - Note: In this scenario, the artifact:local variant builds - - 3. Inspect your cluster if necessary - - When the scenario is finished launching, refer to the scenario outputs to see information - related to your cluster. You can use this information to SSH into nodes and/or to interact - with vault. If using Ubuntu, your SSH user will be `ubuntu`; if using any of the other - supported distros, it will be `ec2-user`. - enos scenario output dev_pr_replication arch:amd64 artifact:deb distro:ubuntu edition:ent.hsm primary_backend:raft primary_seal:awskms secondary_backend:raft secondary_seal:pkcs11 - ssh -i /path/to/your/private/key.pem @ - vault status - - 4. Destroy your resources - - After you've finished, destroy the cluster. - enos scenario destroy dev_pr_replication arch:amd64 artifact:deb distro:ubuntu edition:ent.hsm primary_backend:raft primary_seal:awskms secondary_backend:raft secondary_seal:pkcs11 EOF // The matrix is where we define all the baseline combinations that enos can utilize to customize diff --git a/enos/enos-dev-scenario-single-cluster.hcl b/enos/enos-dev-scenario-single-cluster.hcl index b9da69a556fd..44790c9afd65 100644 --- a/enos/enos-dev-scenario-single-cluster.hcl +++ b/enos/enos-dev-scenario-single-cluster.hcl @@ -65,11 +65,10 @@ scenario "dev_single_cluster" { c. 'artifact:zip' This will download a Vault .zip bundle from releases.hashicorp.com with the version and edition you specify. - - TODO: add required variable 5. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command. + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list dev_single_cluster @@ -80,7 +79,7 @@ scenario "dev_single_cluster" { Notes: - To learn more about any Enos command, use the `--help` flag, e.g.: - + $ enos scenario launch --help - Enos will run all matrix variant combinations that match your filter. If you specify one @@ -107,69 +106,6 @@ scenario "dev_single_cluster" { 7. When you're done, destroy the scenario and associated infrastructure: $ enos scenario destroy dev_single_cluster - - - - - - - In order to execute this scenario you'll need: - - 1. To install the enos CLI: - - $ brew tap hashicorp/tap && brew update && brew install hashicorp/tap/enos - - 2. Access to an AWS account via Doormat. Follow the guide here: - https://eng-handbook.hashicorp.services/internal-tools/enos/getting-started/#authenticate-to-aws-with-doormat - - 3. An SSH keypair set up in your AWS account: - https://eng-handbook.hashicorp.services/internal-tools/enos/getting-started/#set-your-aws-key-pair-name-and-private-key - - Please note that this scenario requires several input variables to be set in order to function - properly. While not all variants will require all variables, it's suggested that you look over - the scenario outline to determine which variables affect which steps and which have inputs that - you should set. You can use the following command to get a textual outline of the entire - scenario: - enos scenario outline dev_single_cluster - - You can also create an HTML version that is suitable for viewing in web browsers: - enos scenario outline dev_single_cluster --format html > index.html - open index.html - - To configure the required variables you have a couple of choices. You can create an - 'enos-local.vars' file in the same 'enos' directory where this scenario is defined. In it you - declare your desired variable values. For example, you could copy the following content and - then set the values as necessary: - - artifactory_username = "username@hashicorp.com" - artifactory_token = " - aws_region = "us-west-2" - aws_ssh_keypair_name = "" - aws_ssh_keypair_key_path = "/path/to/your/private/key.pem" - dev_build_local_ui = false - dev_consul_version = "1.18.1" - vault_license_path = "./support/vault.hclic" - vault_product_version = "1.16.2" - - Alternatively, you can set them in your environment: - export ENOS_VAR_aws_region="us-west-2" - export ENOS_VAR_vault_license_path="./support/vault.hclic" - - After you've configured your inputs you can list and filter the available scenarios and then - subsequently launch and destroy them. - enos scenario list --help - enos scenario launch --help - enos scenario list dev_single_cluster - enos scenario launch dev_single_cluster arch:arm64 artifact:local backend:raft distro:ubuntu edition:ce seal:awskms - - When the scenario is finished launching you refer to the scenario outputs to see information - related to your cluster. You can use this information to SSH into nodes and/or to interact - with vault. - enos scenario output dev_single_cluster arch:arm64 artifact:local backend:raft distro:ubuntu edition:ce seal:awskms - ssh -i /path/to/your/private/key.pem - vault status - - After you've finished you can tear down the cluster - enos scenario destroy dev_single_cluster arch:arm64 artifact:local backend:raft distro:ubuntu edition:ce seal:awskms EOF // The matrix is where we define all the baseline combinations that enos can utilize to customize diff --git a/enos/enos-scenario-agent.hcl b/enos/enos-scenario-agent.hcl index ed89bb4f08c4..e2997d720724 100644 --- a/enos/enos-scenario-agent.hcl +++ b/enos/enos-scenario-agent.hcl @@ -68,7 +68,8 @@ scenario "agent" { artifactory_token = your-token 5. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command: + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list agent @@ -81,7 +82,7 @@ scenario "agent" { - To learn more about any Enos command, use the `--help` flag, e.g.: $ enos scenario launch --help - + - Enos will run all matrix variant combinations that match your filter. If you specify one variant for each matrix item, the filter will produce and run only one scenario. Even if you are using a Raft backend, you may want to specify a consul_version (though it functionally will not diff --git a/enos/enos-scenario-autopilot.hcl b/enos/enos-scenario-autopilot.hcl index b36bd1aadfde..90606395c73d 100644 --- a/enos/enos-scenario-autopilot.hcl +++ b/enos/enos-scenario-autopilot.hcl @@ -72,7 +72,8 @@ scenario "autopilot" { artifactory_token = your-token 5. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command: + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list autopilot diff --git a/enos/enos-scenario-proxy.hcl b/enos/enos-scenario-proxy.hcl index ad128c515f05..51f8aa8c50d1 100644 --- a/enos/enos-scenario-proxy.hcl +++ b/enos/enos-scenario-proxy.hcl @@ -68,7 +68,8 @@ scenario "proxy" { artifactory_token = your-token 5. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command: + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list proxy diff --git a/enos/enos-scenario-replication.hcl b/enos/enos-scenario-replication.hcl index 1f47f785d651..f1474ace4121 100644 --- a/enos/enos-scenario-replication.hcl +++ b/enos/enos-scenario-replication.hcl @@ -73,7 +73,8 @@ scenario "replication" { artifactory_token = your-token 5. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command: + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list replication diff --git a/enos/enos-scenario-seal-ha.hcl b/enos/enos-scenario-seal-ha.hcl index d612f9730bd2..969cbd151975 100644 --- a/enos/enos-scenario-seal-ha.hcl +++ b/enos/enos-scenario-seal-ha.hcl @@ -73,7 +73,8 @@ scenario "seal_ha" { artifactory_token = your-token 5. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command: + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list seal_ha diff --git a/enos/enos-scenario-smoke.hcl b/enos/enos-scenario-smoke.hcl index cb626f725f5d..d4b921aa670e 100644 --- a/enos/enos-scenario-smoke.hcl +++ b/enos/enos-scenario-smoke.hcl @@ -65,7 +65,8 @@ scenario "smoke" { artifactory_token = your-token 5. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command: + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list smoke diff --git a/enos/enos-scenario-ui.hcl b/enos/enos-scenario-ui.hcl index bceae1d73ce3..e3f385900569 100644 --- a/enos/enos-scenario-ui.hcl +++ b/enos/enos-scenario-ui.hcl @@ -46,7 +46,8 @@ scenario "ui" { - vault_license_path (if using an ENT edition of Vault) 4. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command: + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list ui diff --git a/enos/enos-scenario-upgrade.hcl b/enos/enos-scenario-upgrade.hcl index 35e3f1ff1aef..f9f4562a2112 100644 --- a/enos/enos-scenario-upgrade.hcl +++ b/enos/enos-scenario-upgrade.hcl @@ -59,9 +59,7 @@ scenario "upgrade" { vault_artifact_path = path/to/existing-vault-artifact.[zip | rpm | deb] b. 'artifact_source:local' - This will build a Vault .zip bundle from your local branch. Set the following variable: - - vault_artifact_path = path/to/where/vault-should-be-built.zip + This will build a Vault .zip bundle from your local branch. No variables required. c. 'artifact_source:artifactory' This will download a Vault artifact of the specified version, edition, and revision SHA @@ -71,7 +69,8 @@ scenario "upgrade" { artifactory_token = your-token 5. If you don't know yet what combination of matrix variants you want to use for your scenario, you - can view all the possible combinations through the `list` command: + can view all the possible combinations through the `list` command. You can also reduce the list by + adding one or more filter items, e.g. 'arch:amd64' to get just the scenario combinations that use amd64. $ enos scenario list upgrade