As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Implantando a ParallelCluster API com o Terraform
Neste tutorial, você definirá um projeto simples do Terraform para implantar uma ParallelCluster API.
Pré-requisitos
O Terraform v1.5.7+ está instalado.
Função do IAM com as permissões para implantar a ParallelCluster API. Consulte Permissões obrigatórias.
Defina um projeto Terraform
Crie um diretório chamado
my-pcluster-api
.Todos os arquivos que você criar estarão dentro desse diretório.
Crie o arquivo
provider.tf
para configurar o AWS provedor.provider "aws" { region = var.region profile = var.profile }
Crie o arquivo
main.tf
para definir os recursos usando o ParallelCluster módulo.module
"parallelcluster_pcluster_api"
{ source ="aws-tf/parallelcluster/aws//modules/pcluster_api"
version ="1.0.0"
region = var.region api_stack_name = var.api_stack_name api_version = var.api_version deploy_pcluster_api = true parameters = { EnableIamAdminAccess ="true"
} }Crie o arquivo
variables.tf
para definir as variáveis que podem ser injetadas neste projeto.variable "region" { description = "The region the ParallelCluster API is deployed in." type = string default = "us-east-1" } variable "profile" { type = string description = "The AWS profile used to deploy the clusters." default = null } variable "api_stack_name" { type = string description = "The name of the CloudFormation stack used to deploy the ParallelCluster API." default = "ParallelCluster" } variable "api_version" { type = string description = "The version of the ParallelCluster API." }
Crie o arquivo
terraform.tfvars
para definir valores arbitrários para as variáveis.O arquivo abaixo implanta uma ParallelCluster API 3.10.0
us-east-1
usando o nome da pilha.MyParallelClusterAPI-310
Você poderá referenciar essa implantação de ParallelCluster API usando o nome da pilha.region = "us-east-1" api_stack_name = "MyParallelClusterAPI-310" api_version = "3.10.0"
Crie o arquivo
outputs.tf
para definir as saídas retornadas por esse projeto.output "pcluster_api_stack_outputs" { value = module.parallelcluster_pcluster_api.stack_outputs }
O diretório do projeto é:
my-pcluster-api ├── main.tf - Terraform entrypoint to define the resources using the ParallelCluster module. ├── outputs.tf - Defines the outputs returned by Terraform. ├── providers.tf - Configures the AWS provider. ├── terraform.tfvars - Set the arbitrary values for the variables, i.e. region, PCAPI version, PCAPI stack name └── variables.tf - Defines the variables, e.g. region, PCAPI version, PCAPI stack name.
Implantar a API
Para implantar a API, execute os comandos padrão do Terraform em ordem.
Crie o projeto:
terraform init
Defina o plano de implantação:
terraform plan -out tfplan
Implante o plano:
terraform apply tfplan
Permissões obrigatórias
Você precisa das seguintes permissões para implantar a ParallelCluster API com o Terraform:
{ "Version": "2012-10-17", "Statement": [ { "Action": [ "cloudformation:DescribeStacks", "cloudformation:GetTemplate" ], "Resource": "arn:
PARTITION
:cloudformation:REGION
:ACCOUNT
:stack/*", "Effect": "Allow", "Sid": "CloudFormationRead" }, { "Action": [ "cloudformation:CreateStack", "cloudformation:DeleteStack", "cloudformation:CreateChangeSet" ], "Resource": "arn:PARTITION
:cloudformation:REGION
:ACCOUNT
:stack/MyParallelClusterAPI*", "Effect": "Allow", "Sid": "CloudFormationWrite" }, { "Action": [ "cloudformation:CreateChangeSet" ], "Resource": [ "arn:PARTITION
:cloudformation:REGION
:aws:transform/Include", "arn:PARTITION
:cloudformation:REGION
:aws:transform/Serverless-2016-10-31" ], "Effect": "Allow", "Sid": "CloudFormationTransformWrite" }, { "Action": [ "s3:GetObject" ], "Resource": [ "arn:PARTITION
:s3:::*-aws-parallelcluster/parallelcluster/*/api/ParallelCluster.openapi.yaml", "arn:PARTITION
:s3:::*-aws-parallelcluster/parallelcluster/*/layers/aws-parallelcluster/lambda-layer.zip" ], "Effect": "Allow", "Sid": "S3ParallelClusterArtifacts" }, { "Action": [ "iam:CreateRole", "iam:DeleteRole", "iam:GetRole", "iam:CreatePolicy", "iam:DeletePolicy", "iam:GetPolicy", "iam:GetRolePolicy", "iam:AttachRolePolicy", "iam:DetachRolePolicy", "iam:PutRolePolicy", "iam:DeleteRolePolicy", "iam:ListPolicyVersions" ], "Resource": [ "arn:PARTITION
:iam::ACCOUNT
:role/*", "arn:PARTITION
:iam::ACCOUNT
:policy/*" ], "Effect": "Allow", "Sid": "IAM" }, { "Action": [ "iam:PassRole" ], "Resource": [ "arn:PARTITION
:iam::ACCOUNT
:role/ParallelClusterLambdaRole-*", "arn:PARTITION
:iam::ACCOUNT
:role/APIGatewayExecutionRole-*" ], "Effect": "Allow", "Sid": "IAMPassRole" }, { "Action": [ "lambda:CreateFunction", "lambda:DeleteFunction", "lambda:GetFunction", "lambda:PublishLayerVersion", "lambda:DeleteLayerVersion", "lambda:GetLayerVersion", "lambda:TagResource", "lambda:UntagResource" ], "Resource": [ "arn:PARTITION
:lambda:REGION
:ACCOUNT
:layer:PCLayer-*", "arn:PARTITION
:lambda:REGION
:ACCOUNT
:function:*-ParallelClusterFunction-*" ], "Effect": "Allow", "Sid": "Lambda" }, { "Action": [ "logs:CreateLogGroup", "logs:DeleteLogGroup", "logs:DescribeLogGroups", "logs:PutRetentionPolicy", "logs:TagLogGroup", "logs:UntagLogGroup" ], "Resource": [ "arn:PARTITION
:logs:REGION
:ACCOUNT
:log-group:/aws/lambda/*-ParallelClusterFunction-*" ], "Effect": "Allow", "Sid": "Logs" }, { "Action": [ "apigateway:DELETE", "apigateway:GET", "apigateway:PATCH", "apigateway:POST", "apigateway:PUT", "apigateway:UpdateRestApiPolicy" ], "Resource": [ "arn:PARTITION
:apigateway:REGION
::/restapis", "arn:PARTITION
:apigateway:REGION
::/restapis/*", "arn:PARTITION
:apigateway:REGION
::/tags/*" ], "Effect": "Allow", "Sid": "APIGateway" } ] }