Usando a CLI do AWS OpsWorks Stacks

Importante

O AWS OpsWorks Stacks serviço chegou ao fim da vida útil em 26 de maio de 2024 e foi desativado para clientes novos e existentes. É altamente recomendável que os clientes migrem suas cargas de trabalho para outras soluções o mais rápido possível. Se você tiver dúvidas sobre migração, entre em contato com a AWS Support equipe no AWS re:POST ou por meio do Premium AWS Support.

A interface de linha de comando (CLI) do AWS OpsWorks Stacks fornece a mesma funcionalidade do console e pode ser usada para uma variedade de tarefas. A CLI do AWS OpsWorks Stacks faz parte do. AWS CLI Para obter mais informações, incluindo como instalar e configurar o AWS CLI, acesse O que é a interface de linha de comando da AWS? . Para obter uma descrição completa de cada comando, acesse a referência do AWS OpsWorks Stacks.

nota

Se você estiver usando uma estação de trabalho baseada em Windows, também poderá executar AWS as Ferramentas do Windows PowerShell para realizar operações de AWS OpsWorks pilhas na linha de comando. Para obter mais informações, consulte AWS Tools for Windows PowerShell.

AWS OpsWorks Os comandos Stacks têm o seguinte formato geral:

aws opsworks --region us-west-1 opsworks command-name [--argument1 value] [...]

Se um valor de argumento for um objeto JSON, você deve escapar os caracteres " ou o comando pode retornar uma mensagem de erro informando que o JSON não é válido. Por exemplo, se o objeto JSON é "{"somekey":"somevalue"}", você deve formatá-lo como "{\"somekey\":\"somevalue\"}". Uma abordagem alternativa é colocar o objeto JSON em um arquivo e usar file:// para incluí-lo na linha de comando. O exemplo a seguir cria um aplicativo usando um objeto fonte do aplicativo no appsource.json.

aws opsworks --region us-west-1 create-app --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8 --name SimpleJSP --type java --app-source file://appsource.json 

A maioria dos comandos retorna um ou mais valores, empacotados como um objeto JSON. As seções a seguir contêm alguns exemplos. Para obter uma descrição detalhada dos valores de retorno de cada comando, acesse a referência do AWS OpsWorks Stacks.

nota

AWS CLI os comandos devem especificar uma região, conforme mostrado nos exemplos. Os valores válidos para o parâmetro -region são mostrados na tabela a seguir. Para simplificar as cadeias de comando do AWS OpsWorks Stacks, configure a CLI para especificar sua região padrão, para que você possa omitir o parâmetro. --region Se você normalmente trabalha em vários endpoints regionais, não configure o AWS CLI para usar um endpoint regional padrão. O endpoint da região do Canadá (Central) está disponível AWS CLI somente na API; ele não está disponível para pilhas que você cria no. AWS Management Console Para obter mais informações, consulte Configuração da região da AWS.

Nome da região	Código de comando
Região Leste dos EUA (Ohio)	us-east-2
Região Leste dos EUA (N. da Virgínia)	us-east-1
Região Oeste dos EUA (Norte da Califórnia)	us-west-1
Região Oeste dos EUA (Oregon)	us-west-2
Região Canadá (Central)	ca-central-1
Região Europa (Irlanda)	eu-west-1
Região Europa (Londres)	eu-west-2
Região Europa (Paris)	eu-west-3
Região Europa (Frankfurt)	eu-central-1
Região Ásia-Pacífico (Tóquio)	ap-northeast-1
Região da Ásia-Pacífico (Seul)	ap-northeast-2
Região da Ásia-Pacífico (Mumbai)	ap-south-1
Região Ásia-Pacífico (Singapura)	ap-southeast-1
Região Ásia-Pacífico (Sydney)	ap-southeast-2
Região América do Sul (São Paulo)	sa-east-1

Para usar um comando da CLI, você precisa ter as permissões apropriadas. Para obter mais informações sobre os as permissões do AWS OpsWorks Stacks, consulte Gerenciamento de permissões de usuário. Para determinar as permissões necessárias para determinado comando, consulte a página de referência do comando na referência do AWS OpsWorks Stacks.

As seções a seguir descrevem como usar a CLI do AWS OpsWorks Stacks para realizar uma variedade de tarefas comuns.