New – Self-Service Provisioning of Terraform Open-Supply Configurations with AWS Service Catalog

With AWS Service Catalog, you may create, govern, and handle a catalog of infrastructure as code (IaC) templates which might be permitted to be used on AWS. These IaC templates can embrace every part from digital machine pictures, servers, software program, and databases to finish multi-tier software architectures. You possibly can management which IaC templates and variations can be found, what’s configured by every model, and who can entry every template primarily based on particular person, group, division, or price heart. Finish customers reminiscent of engineers, database directors, and knowledge scientists can then rapidly uncover and self-service provision permitted AWS assets that they should use to carry out their each day job capabilities.

When utilizing Service Catalog, step one is to create merchandise primarily based in your IaC templates. You possibly can then gather merchandise, along with configuration info, in a portfolio.

Beginning at present, you may outline Service Catalog merchandise and their assets utilizing both AWS CloudFormation or Hashicorp Terraform and select the software that higher aligns along with your processes and experience. Now you can combine your present Terraform configurations into Service Catalog to have them a part of a centrally permitted portfolio of merchandise and share it with the AWS accounts utilized by your finish customers. On this manner, you may stop inconsistencies and mitigate the danger of noncompliance.

When assets are deployed by Service Catalog, you may preserve least privilege entry throughout provisioning and govern tagging on the deployed assets. Finish customers of Service Catalog decide and select what they want from the listing of merchandise and variations they’ve entry to. Then, they’ll provision merchandise in a single motion whatever the know-how (CloudFormation or Terraform) used for the deployment.

The Service Catalog hub-and-spoke mannequin that permits organizations to manipulate at scale can now be prolonged to incorporate Terraform configurations. With the Service Catalog hub and spoke mannequin, you may centrally handle deployments utilizing a administration/person account relationship:

• One administration account – Used to create Service Catalog merchandise, manage them into portfolios, and share portfolios with person accounts
• A number of person accounts (as much as hundreds) – A person account is any AWS account by which the top customers of Service Catalog are provisioning assets.

Let’s see how this works in follow.

Creating an AWS Service Catalog Product Utilizing Terraform
To get began, I set up the Terraform Reference Engine (provided by AWS on GitHub) that configures the code and infrastructure required for the Terraform open-source engine to work with AWS Service Catalog. I solely want to do that as soon as, within the administration account for Service Catalog, and the setup takes simply minutes. I exploit the automated set up script:

./deploy-tre.sh -r us-east-1

To maintain issues easy for this put up, I create a product deploying a single EC2 occasion utilizing AWS Graviton processors and the Amazon Linux 2023 working system. Right here’s the content material of my important.tf file:

terraform 
  required_providers 
    aws = 
      supply  = "hashicorp/aws"
      model = "~> 4.16"
    
  

  required_version = ">= 1.2.0"


supplier "aws" 
  area  = "us-east-1"


useful resource "aws_instance" "app_server" 
  ami           = "ami-00c39f71452c08778"
  instance_type = "t4g.giant"

  tags = 
    Title = "GravitonServerWithAmazonLinux2023"
  

I check in to the AWS Administration Console within the administration account for Service Catalog. Within the Service Catalog console, I select Product listing within the Administration part of the navigation pane. There, I select Create product.

In Product particulars, I choose Terraform open supply as Product kind. I enter a product identify and outline and the identify of the proprietor.

Within the Model particulars, I select to Add a template file (utilizing a tar.gz archive). Optionally, I can specify the template utilizing an S3 URL or an exterior code repository (on GitHub, GitHub Enterprise Server, or Bitbucket) utilizing an AWS CodeStar supplier.

I enter help particulars and customized tags. Be aware that tags can be utilized to categorize your assets and likewise to test permissions to create a useful resource. Then, I full the creation of the product.

Including an AWS Service Catalog Product Utilizing Terraform to a Portfolio
Now that the Terraform product is prepared, I add it to my portfolio. A portfolio can embrace each Terraform and CloudFormation merchandise. I select Portfolios from the Administrator part of the navigation pane. There, I seek for my portfolio by identify and open it. I select Add product to portfolio. I seek for the Terraform product by identify and choose it.

Terraform merchandise require a launch constraint. The launch constraint specifies the identify of an AWS Id and Entry Administration (IAM) position that’s used to deploy the product. I must individually be certain that this position is created in each account with which the product is shared.

The launch position is assumed by the Terraform open-source engine within the administration account when an finish person launches, updates, or terminates a product. The launch position additionally accommodates permissions to explain, create, and replace a useful resource group for the provisioned product and tag the product assets. On this manner, Service Catalog retains the useful resource group up-to-date and tags the assets related to the product.

The launch position permits least privilege entry for finish customers. With this function, finish customers don’t want permission to immediately provision the product’s underlying assets as a result of your Terraform open-source engine assumes the launch position to provision these assets, reminiscent of an permitted configuration of an Amazon Elastic Compute Cloud (Amazon EC2) occasion.

Within the Launch constraint part, I select Enter position identify to make use of a task I created earlier than for this product:

• The belief relationship of the position defines the entities that may assume the position. For this position, the belief relationship contains Service Catalog and the administration account that accommodates the Terraform Reference Engine.
• For permissions, the position permits to provision, replace, and terminate the assets required by my product and to handle useful resource teams and tags on these assets.

I full the addition of the product to my portfolio. Now the product is on the market to the top customers who’ve entry to this portfolio.

Launching an AWS Service Catalog Product Utilizing Terraform
Finish customers see the listing of merchandise and variations they’ve entry to and may deploy them in a single motion. If you happen to already use Service Catalog, the expertise is similar as with CloudFormation merchandise.

I check in to the AWS Console within the person account for Service Catalog. The portfolio I used earlier than has been shared by the administration account with this person account. Within the Service Catalog console, I select Merchandise from the Provisioning group within the navigation pane. I seek for the product by identify and select Launch product.

I let Service Catalog generate a novel identify for the provisioned product and choose the product model to deploy. Then, I launch the product.

After a couple of minutes, the product has been deployed and is on the market. The deployment has been managed by the Terraform Reference Engine.

Within the Related tags tab, I see that Service Catalog mechanically added info on the portfolio and the product.

Within the Sources tab, I see the assets created by the provisioned product. As anticipated, it’s an EC2 occasion, and I can comply with the hyperlink to open the Amazon EC2 console and get extra info.

Finish customers reminiscent of engineers, database directors, and knowledge scientists can proceed to make use of Service Catalog and launch the merchandise they want with out having to think about if they’re provisioned utilizing Terraform or CloudFormation.

Availability and Pricing
AWS Service Catalog help for Terraform open-source configurations is on the market at present in all AWS Areas the place it’s supplied. There isn’t any change in pricing when utilizing Terraform. With Service Catalog, you pay for the API calls you make to the service, and you can begin totally free with the free tier. You additionally pay for the assets used and created by the Terraform Reference Engine. For extra info, see Service Catalog Pricing.

Allow self-service provisioning at scale in your Terraform open-source configurations.

— Danilo