As a cloud administrator, you can populate the Service Broker catalog with Amazon CloudFormation templates by adding one or more Amazon S3 buckets as content sources and sharing them with project members. The templates are the specifications for the services or applications that you can deploy to Amazon Web Services.

Workflow diagram for importing and deploying CloudFormation templates.

You can only add one bucket as a content source. To add multiple buckets, you create a content source for each bucket.

After you add the templates, you entitle project members to deploy the cloud templates. At the request time, the cloud template is deployed to the cloud account region that you define when you add the content source.

Prerequisites

  • Ensure that you know to name of the S3 bucket that contains your CloudFormation templates.
  • If you are adding a private bucket, you must know the access key and the secret key.
  • Ensure that the CloudFormation template you want to import meets the size limit. The maximum allowed size is 150KB.

Procedure

  1. To deploy your CloudFormation templates, you must have at least one Amazon Web Services cloud account and select the regions.
    1. Select Infrastructure > Connections > Cloud Accounts.
    2. Click Add Cloud Account and then click Amazon Web Services.
    3. Enter the 20-digit Access Key ID and corresponding Secret Access Key.
    4. To verify the credentials, click Validate.
    5. Enter an account name.
      Provide a name that you can identify when you share templates with projects.
    6. Select one or more regions in this account that you want to deploy templates to.
    7. Click Create.
  2. Define cloud zones for the Amazon Web Services cloud account regions.
    1. Select Infrastructure > Configure > Cloud Zones, and then click New Cloud Zone.
    2. Select the Account/region, the Name, and the Placement policy.
    3. Click the Compute tab and verify or modify the resources that are included in the cloud zone.
    4. Click Create.
  3. Import the templates.
    1. Select Content and Policies > Content Sources.
    2. Click New, and then click AWS CloudFormation Template.
    3. Enter the Name for this content source.
    4. Add the S3 bucket information.
    5. Click Validate.
      If the bucket is public, the validation process verifies the name and the number of templates. If the bucket is private, the validation process verifies the name, the keys, and the number of templates.
    6. Select the Deployment Target Amazon Web Services cloud account and a region.
    7. Click Create and Import.
  4. Add a project so that you can share the templates with project members.
    1. In Service Broker, select Infrastructure > Administration > Projects, and then click New Project.
    2. Enter the project information on the Summary tab.
    3. Click the Users tab and then click Add Users.
      To add project users, the individuals or the groups must already be active service organization users.
    4. If this project supports only CloudFormation templates, ignore the Provisioning tab.
      CloudFormation templates are deployed to the target account and region that you defined when you imported the templates. If the project members can deploy other templates or content, you must add the target cloud zones for the content to the project.
    5. Click Create.
    The new project is added to your projects. It is also added to your associated Cloud Assembly instance. If the project is for VMware Cloud Templates, you can add cloud zones in Cloud Assembly. If the project is for templates, you do not need to add cloud zones.
  5. Share the imported templates with a project.
    If you want to share the templates with more than one project, you must create a separate content sharing policy for each project.
    1. Select Content and Policies > Policies > Definitions, and create a new content sharing policy.
    2. Enter a name for the content sharing policy.
    3. In the Scope list, select the project that includes the users who should be able to deploy the templates.
    4. In the Content sharing section, click Add Items, and then select one or more Amazon Web Services content sources to share with the project.
    5. In the Users section, select the users and user groups that you want to have access to the content.
    6. Click Create.
    The templates are added to the catalog where the project members can request them.
  6. Verify that the template is available in the catalog to the members of the selected projects.
    1. Click the Consume tab.
    2. In the Projects drop-down menu, select the project with which you shared the CloudFormation template.

      You can select multiple projects.

    3. On the Catalog page, locate the imported CloudFormation template, and review the projects to ensure that the project you configured is included.
    4. Click Request and provide any required information.
    5. Click Submit.
    The provisioning process begins and the Deployments page opens with your current request at the top.
  7. Monitor the provisioning process to ensure successful deployment.
    1. Select Deployments > Deployments and locate your deployed catalog item.
    2. Monitor the card status until it is successful.

Results

The templates are imported into Service Broker and shared in the catalog.

What to do next