Getting started with the AWS Management Console - AWS Proton

Getting started with the AWS Management Console

Get started with AWS Proton

  • Create and view an environment template.

  • Create, view, and publish a service template that uses the environment template that you just created.

  • Create an environment and service (optional).

  • Delete the service template, environment template, environment and service, if created.

Step 1: Open the AWS Proton console

Step 2: Create an environment template

In the navigation pane, choose Environment templates.

  1. In the Environment templates page, choose Create Environment template.

  2. In the Create environment template page, in the Template options section, choose Create a template for provisioning new environments.

  3. In the Template bundle source section, choose Use one of our sample template bundles.

  4. In the Sample template bundle section, select fargate-environment.

  5. In the Template details section.

    1. Enter the template name as my-env-template.

    2. Enter the environment template display name as My Fargate Environment.

    3. (Optional) Enter a description for the environment template.

  6. (Optional) In the Tags section, choose Add new tag and enter a key and value to create a customer managed tag.

  7. Choose Create Environment template.

    You're now on a new page that displays the status and details for your new environment template. These details include a list of AWS and customer managed tags. AWS Proton automatically generates AWS managed tags for you when you create AWS Proton resources. For more information, see AWS Proton resources and tagging.

  8. Refresh the Template versions section and the status of the new version is Draft. The status of a new environment template status starts in the Draft state. You and others with proton:CreateEnvironment permissions can view and access it. Follow the next step to make the template available to others.

  9. In the Template versions section, choose the radio button to the left of the minor version of the template you just created (1.0). As an alternative, you can choose Publish in the info alert banner and skip the next step.

  10. In the Template versions section, choose Publish.

  11. The template status changes to Published. Because it's the latest version of the template, it's the Recommended version.

  12. In the navigation pane, select Environment templates.

    A new page displays a list of your environment templates along with template details.

Step 3: Create a service template

Create a service template.

  1. In the navigation pane, choose Service templates.

  2. In the Service templates page, choose Create Service template.

  3. In the Create service template page, in the Template bundle source section, choose Use one of our sample template bundles.

  4. In the Sample template bundle section, select fargate-service.

  5. In the Template details section.

    1. Enter the service template name as my-svc-template.

    2. Enter the service template display name as My Fargate Service.

    3. (Optional) Enter a description for the service template.

  6. In the Compatible environment templates section.

    1. Check the check-box to the left of the environment template My Fargate Environment to select the compatible environment template for the new service template.

  7. For Encryption settings, keep the defaults.

  8. In the Pipeline - optional section.

    1. Keep the checkbox checked to include a service pipeline in your service template.

  9. Choose Create service template.

    You're now on a new page that displays the status and details for your new service template, including a list of AWS and customer managed tags.

  10. Refresh the Template versions section and the status of the new version is Draft. The status of a new service template status starts in the Draft state. Only administrators can view and access it. To make the service template available for use by developers, follow the next step.

  11. In the Template versions section, choose the radio button to the left of the minor version of the template you just created (1.0). As an alternative, you can choose Publish in the info alert banner and skip the next step.

  12. In the Template versions section, choose Publish.

  13. The template status changes to Published.

    The first minor version of your service template is published and available for use by developers. Because it's the latest version of the template, it's the Recommended version.

  14. In the navigation pane, choose Service templates.

    A new page displays a list of your service templates and details.

Step 4: Create an environment

In the navigation pane, choose Environments.

  1. Choose Create environment.

  2. In the Choose an environment template page, select the template that you just created. It's named My Fargate Environment. Then, choose Configure.

  3. In the Configure environment page, in the Deployment account section, select This AWS account.

  4. Enter the environment name as my-fargate-environment.

  5. In the Environment roles section, select New service role or, if you have already created an AWS Proton service role, select Existing service role.

    1. Select New service role to create a new role.

      1. Enter the Environment role name as MyProtonServiceRole.

      2. Check the checkbox to agree to create an AWS Proton service role with administrative privileges for your account.

    2. Select Existing service role to use an existing role.

      1. Select your role in the Environment role name drop down field.

  6. Choose Next.

  7. On the Configure custom settings page, use the defaults.

  8. Choose Next and review your inputs.

  9. Choose Create.

    View the environment details and status, as well as the AWS managed tags and customer managed tags for your environment.

  10. In the navigation pane, choose Environments.

    A new page displays a list of your environments along with the status and other environment details.

Step 5: Optional - Create a service and deploy an application

  • After the environment is created and Deployment status is Succeeded, launch a service based on your service template and environment. To do this, follow the instructions at Prerequisites and Create a service in the AWS Proton User Guide.

Step 6: Clean up.

  1. Delete a service (if you created one)

    To delete the service, follow the instructions at Delete a service in the AWS Proton User Guide.

  2. Open the AWS Proton console.

  3. Delete an environment

    1. In the navigation pane, choose Environments.

    2. In the Environments page, select the radio button the left of the environment that you just created.

    3. Choose Actions, then Delete.

    4. A modal prompts you to confirm the delete action.

    5. Follow the instructions and choose Yes, delete.

  4. Delete a service template

    1. In the navigation pane, choose Service templates.

    2. In the Service templates page, select the radio button to the left of service template my-svc-template.

    3. Choose Actions, then Delete.

    4. A modal prompts you to confirm the delete action.

    5. Follow the instructions and choose Yes, delete. This deletes the service template and all of its versions.

  5. Delete an environment template

    1. In the navigation pane, choose Environment templates.

    2. In the Environment templates page, select the radio button to the left of my-env-template.

    3. Choose Actions, then Delete.

    4. A modal prompts you to confirm the delete action.

    5. Follow the instructions and choose Yes, delete. This deletes the environment template and all of its versions.