A Manifest is a YAML file. Stax interprets the Manifest and deploys whatever is outlined within the Manifest. Stax Workloads utilize AWS CloudFormation for deployment. The Manifest can reference one or more CloudFormation templates which Stax will execute.
When defining your Manifest, it should consist of the sections below.
The AWS resources that will be deployed. Resources will be sequentially created in order of definition.
The below example will deploy two Cloudformation Stacks. First the S3Bucket Stack, then the EC2Instance Stack.
A Stax Workloads manifest can support up to 10 individual resources.
Resources: - S3Bucket: Type: AWS::Cloudformation TemplateURL: s3://example-artifactbucket/cloudformation/s3.yml - EC2Instance: Type: AWS::Cloudformation TemplateURL: s3://example-artifactbucket/cloudformation/ec2.yml
These are the parameters that the AWS resources require in order to be deployed. Read more about Workload Parameters.
These are the CloudFormation resources that you wish to protect from being modified, replaced, or deleted. You can either list the individual resources you want protected or pass
All for the whole stack to be protected. Read more about Protected Resources.
When creating a Manifest, utilize the following formatting:
- Top Level key
Resourcesmust be of list type
- Values in
Resourceslist must be of dictionary type
- Each item in the dictionary must include the
TemplateBodykeys are optional values, but one is required for a valid Workload Manifest
Parameterskey is optional, but the value must be of dictionary type
ProtectedResourceskey is optional, but must be of dictionary type
- When naming your Workloads and resources, be sure that lengths do not exceed the defined limits.
An example Manifest is shown below. This Manifest creates the S3Bucket Cloudformation Stack and passes two parameters to the s3.yml template. Protection has also been enabled on the CustomResource1 resource in the s3.yml template.
Resources: - S3Bucket: Type: AWS::Cloudformation TemplateURL: s3://example-artifactbucket/cloudformation/s3.yml Parameters: BucketName: my-s3-bucket BucketDeletionPolicy: Retain ProtectedResources: All: - CustomResource1
Stax validates the structure of Workload Manifests, as well as ensuring that the references to CloudFormation templates are reachable, and are valid JSON or YAML.
When developing a CloudFormation template, it is recommended to validate the template using the AWS Console, CLI, or API. When doing so, target a similar account and region to the Workload Catalog item's intended target.