The Quick Start team runs all Quick Starts through an automated validation and integration system. The validation test requires the following:

  • A configuration file named config.yml in the ci subfolder of the GitHub repo. This file is generated automatically. Edit the file to specify your AWS CloudFormation templates and parameter files, and commit to the develop branch when you’re ready for the validation test. If you want to configure your test to run in specific regions, see the instructions in the Quick Start Automated Validation user guide. Make sure to always use the master template in any tests defined in the config.yml file.

  • An AWS CloudFormation parameters file in JSON format with a list of parameters and their defaults. For the following parameters that require user input, use these special values:

    • Key-pair name:

      cikey

    • Password generation:

      $[alfred_genpass_x]

      where x is the number of characters of a random string with uppercase [A-Z], lowercase [a-z], and number [0-9] characters.

    • Availability Zone generation:

      $[alfred_genaz_x]

      where x is the number of Availability Zones you expect as a comma-separated string.

    • Single Availability Zone generation:

      $[alfred_gensingleaz_x]

      where x is the number of the Availability Zone you expect as a string. For example, 1 returns the first Availability Zone in that region or account, 2 returns the second Availability Zone in that region or account, and so on.

    • UUID/GUID generation:

      $[alfred_genuuid]

      [
          {
              "ParameterKey": "KeyPairName",
              "ParameterValue": "cikey"
          },
          {
              "ParameterKey": "AdminPassword",
              "ParameterValue": "$[alfred_genpass_32]"
          },
          {
              "ParameterKey": "AdminUser",
              "ParameterValue": "StackAdmin"
          },
          {
              "ParameterKey": "AvailabilityZones",
              "ParameterValue": "$[alfred_genaz_2]"
          },
          {
              "ParameterKey": "CodeDeployAppName",
              "ParameterValue": "$[alfred_genpass_16]"
          },
          {
              "ParameterKey": "CodeDeployDeploymentGroupName",
              "ParameterValue": "$[alfred_genuuid]"
          },
          {
              "ParameterKey": "CodeDeployNumberOfServers",
              "ParameterValue": "2"
          },
      ...
  • Do not add the QSS3BucketName and QSS3KeyPrefix names to the parameters file. These parameters are automatically modified by the validation/integration system directly in the template when launching tests.