Exemplos do AWS OpsWorks usando oAWS CLI

Como atribuir uma instância registrada a uma camada

O exemplo a seguir atribui uma instância registrada a uma camada personalizada.

aws opsworks --region us-east-1 assign-instance --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2 --layer-ids 26cf1d32-6876-42fa-bbf1-9cadc0bff938

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Atribuir uma instância registrada a uma camada no Guia do usuário do AWS OpsWorks.

Como atribuir um volume registrado a uma instância

O exemplo a seguir atribui um volume registrado do Amazon Elastic Block Store (Amazon EBS) a uma instância. O volume é identificado pelo ID do volume, que é o GUID que o AWS OpsWorks atribui quando é feito o registro do volume em uma pilha, não pelo ID do volume do Amazon Elastic Compute Cloud (Amazon EC2). Antes de executar assign-volume, primeiro é necessário executar update-volume para atribuir um ponto de montagem ao volume.

aws opsworks --region us-east-1 assign-volume --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2 --volume-id 26cf1d32-6876-42fa-bbf1-9cadc0bff938

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Atribuir volumes do Amazon EBS a uma instância no Guia do usuário do AWS OpsWorks.

Como associar um endereço IP elástico a uma instância

O exemplo a seguir associa o endereço IP elástico com a instância especificada.

aws opsworks --region us-east-1 associate-elastic-ip --instance-id dfe18b02-5327-493d-91a4-c5c0c448927f --elastic-ip 54.148.130.96

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Gerenciamento de recursos no Guia do usuário do AWS OpsWorks.

Como anexar um balanceador de carga a uma camada

O exemplo a seguir anexa um balanceador de carga, identificado por seu nome, a uma camada especificada.

aws opsworks --region us-east-1 attach-elastic-load-balancer --elastic-load-balancer-name Java-LB --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Balanceamento de carga elástico no Manual do usuário do AWS OpsWorks.

Exemplo 1: criar um app

O exemplo a seguir cria uma aplicação PHP chamada SimplePHPApp a partir do código armazenado em um repositório do GitHub. O comando usa a forma abreviada da definição da fonte da aplicação.

aws opsworks create-app \
    --region us-east-1 \
    --stack-id f6673d70-32e6-4425-8999-265dd002fec7 \
    --name SimplePHPApp \
    --type php \
    --app-source Type=git,Url=git://github.com/amazonwebservices/opsworks-demo-php-simple-app.git,Revision=version1

Saída:

{
    "AppId": "6cf5163c-a951-444f-a8f7-3716be75f2a2"
}

Exemplo 2: criar uma aplicação com um banco de dados anexado

O exemplo a seguir cria uma aplicação JSP a partir do código armazenado em um arquivo .zip em um bucket público do S3. Ele anexa uma instância de banco de dados do RDS para servir como armazenamento de dados da aplicação. As fontes da aplicação e do banco de dados são definidas em arquivos JSON separados que estão no diretório a partir do qual o comando é executado.

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

As informações da fonte da aplicação estão em appsource.json e contêm o que se segue.

{
    "Type": "archive",
    "Url": "https://s3.amazonaws.com/opsworks-demo-assets/simplejsp.zip"
}

As informações da fonte do banco de dados estão em datasource.json e contêm o seguinte.

[
    {
        "Type": "RdsDbInstance",
        "Arn": "arn:aws:rds:us-west-2:123456789012:db:clitestdb",
        "DatabaseName": "mydb"
    }
]

Observação: para uma instância de banco de dados do RDS, é necessário primeiro usar register-rds-db-instance para registrar a instância na pilha. Para instâncias do MySQL App Server, defina Type como OpsworksMysqlInstance. Essas instâncias são criadas pelo AWS OpsWorks e, portanto, não precisam ser registradas.

Saída:

{
    "AppId": "26a61ead-d201-47e3-b55c-2a7c666942f8"
}

Para obter mais informações, consulte Adicionar aplicações no Guia do usuário do AWS OpsWorks.

Exemplo 1: implantar aplicações e executar comandos de pilha

O exemplo a seguir mostra como usar o comando create-deployment para implantar aplicações e executar comandos de pilha. Observe que os caracteres aspas (") no objeto JSON que especifica o comando são todos precedidos por caracteres de escape (\). Sem os caracteres de escape, o comando pode retornar um erro JSON inválido.

O exemplo create-deployment a seguir implanta uma aplicação na pilha especificada.

aws opsworks create-deployment \
    --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf \
    --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb
    --command "{\"Name\":\"deploy\"}"

Saída:

{
    "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560"
}

Exemplo 2: implantar uma aplicação Rails e migrar o banco de dados

O comando create-deployment a seguir implanta uma aplicação Ruby on Rails em uma pilha especificada e migra o banco de dados.

aws opsworks create-deployment \
    --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf \
    --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb \
    --command "{\"Name\":\"deploy\", \"Args\":{\"migrate\":[\"true\"]}}"

Saída:

{
    "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560"
}

Para obter mais informações sobre implantação, consulte Implantação de aplicações no Guiado usuário do AWS OpsWorks.

Exemplo 3: executar uma fórmula

O comando create-deployment a seguir executa uma fórmula personalizada, phpapp::appsetup, nas instâncias em uma pilha especificada.

aws opsworks create-deployment \
    --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb \
    --command "{\"Name\":\"execute_recipes\", \"Args\":{\"recipes\":[\"phpapp::appsetup\"]}}"

Saída:

{
    "DeploymentId": "5cbaa7b9-4e09-4e53-aa1b-314fbd106038"
}

Para obter mais informações, consulte Comandos de execução da pilha no Guia do usuário do AWS OpsWorks.

Exemplo 4: instalar dependências

O comando create-deployment a seguir instala dependências, como pacotes ou gems Ruby, nas instâncias em uma pilha especificada.

aws opsworks create-deployment \
    --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb \
    --command "{\"Name\":\"install_dependencies\"}"

Saída:

{
    "DeploymentId": "aef5b255-8604-4928-81b3-9b0187f962ff"
}

Para obter mais informações, consulte Comandos de execução da pilha no Guia do usuário do AWS OpsWorks.

Para criar uma instância

O comando create-instance a seguir cria uma instância m1.large Amazon Linux chamada myinstance1 na pilha especificada. A instância é atribuída a uma camada.

aws opsworks --region us-east-1 create-instance --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --layer-ids 5c8c272a-f2d5-42e3-8245-5bf3927cb65b --hostname myinstance1 --instance-type m1.large --os "Amazon Linux"

Para usar um nome gerado automaticamente, chame get-hostname-suggestion, que gera um nome de host com base no tema especificado ao criar a pilha. Em seguida, passe esse nome para o argumento hostname.

Saída:

{
  "InstanceId": "5f9adeaa-c94c-42c6-aeef-28a5376002cd"
}

Mais informações

Para obter mais informações, consulte Adicionar uma instância a uma camada no Guia do usuário do AWS OpsWorks.

Para criar uma camada

O comando create-layer a seguir cria uma camada do PHP App Server chamada MyPHPLayer em uma pilha especificada.

aws opsworks create-layer --region us-east-1 --stack-id f6673d70-32e6-4425-8999-265dd002fec7 --type php-app --name MyPHPLayer --shortname myphplayer

Saída:

{
  "LayerId": "0b212672-6b4b-40e4-8a34-5a943cf2e07a"
}

Mais informações

Para obter mais informações, consulte Criar uma camada no Guia do usuário do AWS OpsWorks.

Para criar um servidor

O exemplo create-server a seguir cria um novo servidor Chef Automate chamado automate-06 em sua região padrão. Observe que os padrões são usados na maioria das outras configurações, como no número de backups a serem retidos e nos horários de início de manutenção e backup. Antes de executar um comando create-server, é necessário concluir os pré-requisitos em Introdução ao AWS OpsWorks para Chef Automate no Guia do usuário do AWS Opsworks for Chef Automate.

aws opsworks-cm create-server \
    --engine "ChefAutomate" \
    --instance-profile-arn "arn:aws:iam::012345678901:instance-profile/aws-opsworks-cm-ec2-role" \
    --instance-type "t2.medium" \
    --server-name "automate-06" \
    --service-role-arn "arn:aws:iam::012345678901:role/aws-opsworks-cm-service-role"

Saída:

{
    "Server": {
        "AssociatePublicIpAddress": true,
        "BackupRetentionCount": 10,
        "CreatedAt": 2019-12-29T13:38:47.520Z,
        "DisableAutomatedBackup": FALSE,
        "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com",
        "Engine": "ChefAutomate",
        "EngineAttributes": [
            {
                "Name": "CHEF_AUTOMATE_ADMIN_PASSWORD",
                "Value": "1Example1"
            }
        ],
        "EngineModel": "Single",
        "EngineVersion": "2019-08",
        "InstanceProfileArn": "arn:aws:iam::012345678901:instance-profile/aws-opsworks-cm-ec2-role",
        "InstanceType": "t2.medium",
        "PreferredBackupWindow": "Sun:02:00",
        "PreferredMaintenanceWindow": "00:00",
        "SecurityGroupIds": [ "sg-12345678" ],
        "ServerArn": "arn:aws:iam::012345678901:instance/automate-06-1010V4UU2WRM2",
        "ServerName": "automate-06",
        "ServiceRoleArn": "arn:aws:iam::012345678901:role/aws-opsworks-cm-service-role",
        "Status": "CREATING",
        "SubnetIds": [ "subnet-12345678" ]
    }
}

Para obter mais informações, consulte CreateServer na Referência da API do AWS OpsWorks para Chef Automate.

Para criar uma pilha

O comando create-stack a seguir cria uma pilha chamada CLI Stack.

aws opsworks create-stack --name "CLI Stack" --stack-region "us-east-1" --service-role-arn arn:aws:iam::123456789012:role/aws-opsworks-service-role --default-instance-profile-arn arn:aws:iam::123456789012:instance-profile/aws-opsworks-ec2-role --region us-east-1

Os parâmetros service-role-arn e default-instance-profile-arn são obrigatórios. Normalmente, são usados os que o AWS OpsWorks cria ao criar a primeira pilha. Para obter os nome do recurso da Amazon (ARN) para sua conta, acesse o console do IAM, selecione Roles no painel de navegação, escolha a função ou o perfil e selecione a guia Summary.

Saída:

{
  "StackId": "f6673d70-32e6-4425-8999-265dd002fec7"
}

Mais informações

Para obter mais informações, consulte Criar uma nova pilha no Guia do usuário do AWS OpsWorks.

Para criar um perfil de usuário

É possível importar um usuário do AWS Identity and Access Manager (IAM) para o AWS OpsWorks chamando create-user-profile para criar um perfil de usuário. O exemplo a seguir cria um perfil de usuário para o usuário do IAM cli-user-test, que é identificado pelo nome do recurso da Amazon (ARN). O exemplo atribui ao usuário um nome de usuário SSH myusername e ativa o autogerenciamento, o que permite que o usuário especifique uma chave pública SSH.

aws opsworks --region us-east-1 create-user-profile --iam-user-arn arn:aws:iam::123456789102:user/cli-user-test --ssh-username myusername --allow-self-management

Saída:

{
  "IamUserArn": "arn:aws:iam::123456789102:user/cli-user-test"
}

Dica: esse comando importa um usuário do IAM para o AWS OpsWorks, mas somente com as permissões concedidas pelas políticas anexadas. É possível conceder permissões por pilha do AWS OpsWorks usando o comando set-permissions.

Mais informações

Para obter mais informações, consulte Importar usuários para o AWS OpsWorks no Guia do Usuário do AWS OpsWorks.

Para excluir uma aplicação

O exemplo a seguir exclui uma aplicação especificada, identificada pelo ID da aplicação. É possível obter uma ID da aplicação acessando a página de detalhes da aplicação no console do AWS OpsWorks ou executando o comando describe-apps.

aws opsworks delete-app --region us-east-1 --app-id 577943b9-2ec1-4baf-a7bf-1d347601edc5

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Aplicações no Guia do usuário do AWS OpsWorks.

Para excluir uma instância

O exemplo delete-instance a seguir exclui uma instância especificada, identificada pelo ID da instância. É possível encontrar um ID de instância abrindo a página de detalhes da instância no console do AWS OpsWorks ou executando o comando describe-instances.

Se a instância estiver on-line, primeiro é necessário interrompê-la chamando stop-instance, e em seguida, aguardar até que a instância seja interrompida. Execute describe-instances para verificar o status da instância.

Para remover os volumes do Amazon EBS ou os endereços IP elásticos da instância, adicione os argumentos --delete-volumes ou --delete-elastic-ip, respectivamente.

aws opsworks delete-instance \
    --region us-east-1 \
    --instance-id 3a21cfac-4a1f-4ce2-a921-b2cfba6f7771

Este comando não produz saída.

Para obter mais informações, consulte Excluir instâncias do AWS OpsWorks no Guia do usuário do AWS OpsWorks.

Para excluir uma camada

O exemplo a seguir exclui uma camada especificada, identificada pelo ID da camada. É possível obter uma ID de camada acessando a página de detalhes da camada no console do AWS OpsWorks ou executando o comando describe-layers.

Observação: antes de excluir uma camada, é necessário usar delete-instance para excluir todas as instâncias da camada.

aws opsworks delete-layer --region us-east-1 --layer-id a919454e-b816-4598-b29a-5796afb498ed

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Excluir instâncias do AWS OpsWorks no Guia do usuário do AWS OpsWorks.

Para excluir uma pilha

O exemplo a seguir exclui uma pilha especificada, identificada pelo ID da pilha. É possível obter uma ID da pilha clicando em Configurações da pilha no console do AWS OpsWorks ou executando o comando describe-stacks.

Observação: antes de excluir uma camada, é necessário usar delete-app, delete-instance e delete-layer para excluir todos as aplicações, instâncias e camadas da pilha.

aws opsworks delete-stack --region us-east-1 --stack-id 154a9d89-7e9e-433b-8de8-617e53756c84

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Desativar uma pilha no Guia do usuário do AWS OpsWorks.

Para excluir um perfil de usuário e remover um usuário do IAM do AWS OpsWorks

O exemplo a seguir exclui o perfil de usuário de um usuário do AWS Identity and Access Management (IAM) especificado, identificado pelo nome do recurso da Amazon (ARN). A operação remove o usuário do AWS OpsWorks, mas não exclui o usuário do IAM. É necessário usar o console da IAM, a CLI ou a API para essa tarefa.

aws opsworks --region us-east-1 delete-user-profile --iam-user-arn arn:aws:iam::123456789102:user/cli-user-test

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Importar usuários para o AWS OpsWorks no Guia do Usuário do AWS OpsWorks.

Como cancelar o registro de um endereço IP elástico de uma pilha

O exemplo a seguir cancela o registro de um endereço IP elástico, identificado por seu endereço IP, de sua pilha.

aws opsworks deregister-elastic-ip --region us-east-1 --elastic-ip 54.148.130.96

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Cancelar o registro de endereços IP elásticos no Guia do usuário do AWS OpsWorks.

Como cancelar o registro de uma instância registrada de uma pilha

O comando deregister-instance a seguir cancela o registro de uma instância registrada de sua pilha.

aws opsworks --region us-east-1 deregister-instance --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Cancelar o registro de uma instância registrada no Guia do usuário do AWS OpsWorks.

Como cancelar o registro de uma instância de banco de dados do Amazon RDS a partir de uma pilha

O exemplo a seguir cancela o registro de uma instância de banco de dados do RDS, identificada por seu ARN, de sua pilha.

aws opsworks deregister-rds-db-instance --region us-east-1 --rds-db-instance-arn arn:aws:rds:us-west-2:123456789012:db:clitestdb

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Cancelar o registro de instâncias do Amazon RDS no Guia do usuário do ASW OpsWorks.

ID da instância: clitestdb Nome de usuário principal: cliuser PWD principal: some23!pwd Nome do banco de dados: mydb aws opsworks deregister-rds-db-instance --region us-east-1 --rds-db-instance-arn arn:aws:rds:us-west-2:645732743964:db:clitestdb

Como cancelar o registro de volume do Amazon EBS

O exemplo a seguir cancela o registro de um volume do EBS de sua pilha. O volume é identificado pelo ID do volume, que é o GUID que o AWS OpsWorks atribui quando é feito o registro do volume em uma pilha, não pelo ID do volume do EC2.

aws opsworks deregister-volume --region us-east-1 --volume-id 5c48ef52-3144-4bf5-beaa-fda4deb23d4d

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Cancelar o registro de volumes do Amazon EBS no Guia do usuário do AWS OpsWorks.

Para descrever aplicações

O comando describe-apps a seguir descreve as aplicações na pilha especificada.

aws opsworks describe-apps \
    --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a \
    --region us-east-1

Saída:

{
    "Apps": [
        {
            "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
            "AppSource": {
            "Url": "https://s3-us-west-2.amazonaws.com/opsworks-demo-assets/simplejsp.zip",
            "Type": "archive"
        },
            "Name": "SimpleJSP",
            "EnableSsl": false,
            "SslConfiguration": {},
            "AppId": "da1decc1-0dff-43ea-ad7c-bb667cd87c8b",
            "Attributes": {
            "RailsEnv": null,
            "AutoBundleOnDeploy": "true",
            "DocumentRoot": "ROOT"
        },
            "Shortname": "simplejsp",
            "Type": "other",
            "CreatedAt": "2013-08-01T21:46:54+00:00"
        }
    ]
}

Para obter mais informações, consulte Aplicações no Guia do usuário do AWS OpsWorks.

Para descrever comandos

O comando describe-commands a seguir descreve os comandos na instância especificada.

aws opsworks describe-commands \
    --instance-id 8c2673b9-3fe5-420d-9cfa-78d875ee7687 \
    --region us-east-1

Saída:

{
    "Commands": [
        {
            "Status": "successful",
            "CompletedAt": "2013-07-25T18:57:47+00:00",
            "InstanceId": "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
            "DeploymentId": "6ed0df4c-9ef7-4812-8dac-d54a05be1029",
            "AcknowledgedAt": "2013-07-25T18:57:41+00:00",
            "LogUrl": "https://s3.amazonaws.com/<bucket-name>/logs/008c1a91-ec59-4d51-971d-3adff54b00cc?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE &Expires=1375394373&Signature=HkXil6UuNfxTCC37EPQAa462E1E%3D&response-cache-control=private&response-content-encoding=gzip&response-content- type=text%2Fplain",
            "Type": "undeploy",
            "CommandId": "008c1a91-ec59-4d51-971d-3adff54b00cc",
            "CreatedAt": "2013-07-25T18:57:34+00:00",
            "ExitCode": 0
        },
        {
            "Status": "successful",
            "CompletedAt": "2013-07-25T18:55:40+00:00",
            "InstanceId": "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
            "DeploymentId": "19d3121e-d949-4ff2-9f9d-94eac087862a",
            "AcknowledgedAt": "2013-07-25T18:55:32+00:00",
            "LogUrl": "https://s3.amazonaws.com/<bucket-name>/logs/899d3d64-0384-47b6-a586-33433aad117c?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE &Expires=1375394373&Signature=xMsJvtLuUqWmsr8s%2FAjVru0BtRs%3D&response-cache-control=private&response-content-encoding=gzip&response-conten t-type=text%2Fplain",
            "Type": "deploy",
            "CommandId": "899d3d64-0384-47b6-a586-33433aad117c",
            "CreatedAt": "2013-07-25T18:55:29+00:00",
            "ExitCode": 0
        }
    ]
}

Para obter mais informações, consulte Eventos de ciclo de vida do AWS OpsWorks no Guia do usuário do AWS OpsWorks.

Para descrever implantações

O comando describe-deployments a seguir descreve as implantações na pilha especificada.

aws opsworks --region us-east-1 describe-deployments --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a

Saída:

{
  "Deployments": [
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Status": "successful",
          "CompletedAt": "2013-07-25T18:57:49+00:00",
          "DeploymentId": "6ed0df4c-9ef7-4812-8dac-d54a05be1029",
          "Command": {
              "Args": {},
              "Name": "undeploy"
          },
          "CreatedAt": "2013-07-25T18:57:34+00:00",
          "Duration": 15,
          "InstanceIds": [
              "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
              "9e588a25-35b2-4804-bd43-488f85ebe5b7"
          ]
      },
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Status": "successful",
          "CompletedAt": "2013-07-25T18:56:41+00:00",
          "IamUserArn": "arn:aws:iam::123456789012:user/someuser",
          "DeploymentId": "19d3121e-d949-4ff2-9f9d-94eac087862a",
          "Command": {
              "Args": {},
              "Name": "deploy"
          },
          "InstanceIds": [
              "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
              "9e588a25-35b2-4804-bd43-488f85ebe5b7"
          ],
          "Duration": 72,
          "CreatedAt": "2013-07-25T18:55:29+00:00"
      }
  ]
}

Mais informações

Para obter mais informações, consulte Implantar aplicações no Guia do usuário do AWS OpsWorks.

Para descrever instâncias de um IP elástico

O comando describe-elastic-ips a seguir descreve os endereços IP elásticos na instância especificada.

aws opsworks --region us-east-1 describe-elastic-ips --instance-id b62f3e04-e9eb-436c-a91f-d9e9a396b7b0

Saída:

{
  "ElasticIps": [
      {
          "Ip": "192.0.2.0",
          "Domain": "standard",
          "Region": "us-west-2"
      }
  ]
}

Mais informações

Para obter mais informações, consulte instâncias no Guia do usuário do AWS OpsWorks.

Para descrever os balanceadores de carga elásticos de uma pilha

O comando describe-elastic-load-balancers a seguir descreve os balanceadores de carga elásticos na pilha especificada.

aws opsworks --region us-west-2 describe-elastic-load-balancers --stack-id 6f4660e5-37a6-4e42-bfa0-1358ebd9c182

Saída: essa pilha específica tem um balanceador de carga.

{
  "ElasticLoadBalancers": [
      {
          "SubnetIds": [
              "subnet-60e4ea04",
              "subnet-66e1c110"
          ],
          "Ec2InstanceIds": [],
          "ElasticLoadBalancerName": "my-balancer",
          "Region": "us-west-2",
          "LayerId": "344973cb-bf2b-4cd0-8d93-51cd819bab04",
          "AvailabilityZones": [
              "us-west-2a",
              "us-west-2b"
          ],
          "VpcId": "vpc-b319f9d4",
          "StackId": "6f4660e5-37a6-4e42-bfa0-1358ebd9c182",
          "DnsName": "my-balancer-2094040179.us-west-2.elb.amazonaws.com"
      }
  ]
}

Mais informações

Para obter mais informações, consulte Aplicações no Guia do usuário do AWS OpsWorks.

Para descrever instâncias

O comando describe-instances a seguir descreve as instâncias na pilha especificada:

aws opsworks --region us-east-1 describe-instances --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Saída: a saída do exemplo a seguir é para uma pilha com duas instâncias. A primeira é uma instância registrada do EC2 e a segunda foi criada pelo AWS OpsWorks.

{
  "Instances": [
    {
      "StackId": "71c7ca72-55ae-4b6a-8ee1-a8dcded3fa0f",
      "PrivateDns": "ip-10-31-39-66.us-west-2.compute.internal",
      "LayerIds": [
        "26cf1d32-6876-42fa-bbf1-9cadc0bff938"
      ],
      "EbsOptimized": false,
      "ReportedOs": {
        "Version": "14.04",
        "Name": "ubuntu",
        "Family": "debian"
      },
      "Status": "online",
      "InstanceId": "4d6d1710-ded9-42a1-b08e-b043ad7af1e2",
      "SshKeyName": "US-West-2",
      "InfrastructureClass": "ec2",
      "RootDeviceVolumeId": "vol-d08ec6c1",
      "SubnetId": "subnet-b8de0ddd",
      "InstanceType": "t1.micro",
      "CreatedAt": "2015-02-24T20:52:49+00:00",
      "AmiId": "ami-35501205",
      "Hostname": "ip-192-0-2-0",
      "Ec2InstanceId": "i-5cd23551",
      "PublicDns": "ec2-192-0-2-0.us-west-2.compute.amazonaws.com",
      "SecurityGroupIds": [
        "sg-c4d3f0a1"
      ],
      "Architecture": "x86_64",
      "RootDeviceType": "ebs",
      "InstallUpdatesOnBoot": true,
      "Os": "Custom",
      "VirtualizationType": "paravirtual",
      "AvailabilityZone": "us-west-2a",
      "PrivateIp": "10.31.39.66",
      "PublicIp": "192.0.2.06",
      "RegisteredBy": "arn:aws:iam::123456789102:user/AWS/OpsWorks/OpsWorks-EC2Register-i-5cd23551"
    },
    {
      "StackId": "71c7ca72-55ae-4b6a-8ee1-a8dcded3fa0f",
      "PrivateDns": "ip-10-31-39-158.us-west-2.compute.internal",
      "SshHostRsaKeyFingerprint": "69:6b:7b:8b:72:f3:ed:23:01:00:05:bc:9f:a4:60:c1",
      "LayerIds": [
        "26cf1d32-6876-42fa-bbf1-9cadc0bff938"
      ],
      "EbsOptimized": false,
      "ReportedOs": {},
      "Status": "booting",
      "InstanceId": "9b137a0d-2f5d-4cc0-9704-13da4b31fdcb",
      "SshKeyName": "US-West-2",
      "InfrastructureClass": "ec2",
      "RootDeviceVolumeId": "vol-e09dd5f1",
      "SubnetId": "subnet-b8de0ddd",
      "InstanceProfileArn": "arn:aws:iam::123456789102:instance-profile/aws-opsworks-ec2-role",
      "InstanceType": "c3.large",
      "CreatedAt": "2015-02-24T21:29:33+00:00",
      "AmiId": "ami-9fc29baf",
      "SshHostDsaKeyFingerprint": "fc:87:95:c3:f5:e1:3b:9f:d2:06:6e:62:9a:35:27:e8",
      "Ec2InstanceId": "i-8d2dca80",
      "PublicDns": "ec2-192-0-2-1.us-west-2.compute.amazonaws.com",
      "SecurityGroupIds": [
        "sg-b022add5",
        "sg-b122add4"
      ],
      "Architecture": "x86_64",
      "RootDeviceType": "ebs",
      "InstallUpdatesOnBoot": true,
      "Os": "Amazon Linux 2014.09",
      "VirtualizationType": "paravirtual",
      "AvailabilityZone": "us-west-2a",
      "Hostname": "custom11",
      "PrivateIp": "10.31.39.158",
      "PublicIp": "192.0.2.0"
    }
  ]
}

Mais informações

Para obter mais informações, consulte instâncias no Guia do usuário do AWS OpsWorks.

Para descrever as camadas de uma pilha

O comando describe-layers a seguir descreve as camadas na pilha especificada:

aws opsworks --region us-east-1 describe-layers --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a

Saída:

{
  "Layers": [
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Type": "db-master",
          "DefaultSecurityGroupNames": [
              "AWS-OpsWorks-DB-Master-Server"
          ],
          "Name": "MySQL",
          "Packages": [],
          "DefaultRecipes": {
              "Undeploy": [],
              "Setup": [
                  "opsworks_initial_setup",
                  "ssh_host_keys",
                  "ssh_users",
                  "mysql::client",
                  "dependencies",
                  "ebs",
                  "opsworks_ganglia::client",
                  "mysql::server",
                  "dependencies",
                  "deploy::mysql"
              ],
              "Configure": [
                  "opsworks_ganglia::configure-client",
                  "ssh_users",
                  "agent_version",
                  "deploy::mysql"
              ],
              "Shutdown": [
                  "opsworks_shutdown::default",
                  "mysql::stop"
              ],
              "Deploy": [
                  "deploy::default",
                  "deploy::mysql"
              ]
          },
          "CustomRecipes": {
              "Undeploy": [],
              "Setup": [],
              "Configure": [],
              "Shutdown": [],
              "Deploy": []
          },
          "EnableAutoHealing": false,
          "LayerId": "41a20847-d594-4325-8447-171821916b73",
          "Attributes": {
              "MysqlRootPasswordUbiquitous": "true",
              "RubygemsVersion": null,
              "RailsStack": null,
              "HaproxyHealthCheckMethod": null,
              "RubyVersion": null,
              "BundlerVersion": null,
              "HaproxyStatsPassword": null,
              "PassengerVersion": null,
              "MemcachedMemory": null,
              "EnableHaproxyStats": null,
              "ManageBundler": null,
              "NodejsVersion": null,
              "HaproxyHealthCheckUrl": null,
              "MysqlRootPassword": "*****FILTERED*****",
              "GangliaPassword": null,
              "GangliaUser": null,
              "HaproxyStatsUrl": null,
              "GangliaUrl": null,
              "HaproxyStatsUser": null
          },
          "Shortname": "db-master",
          "AutoAssignElasticIps": false,
          "CustomSecurityGroupIds": [],
          "CreatedAt": "2013-07-25T18:11:19+00:00",
          "VolumeConfigurations": [
              {
                  "MountPoint": "/vol/mysql",
                  "Size": 10,
                  "NumberOfDisks": 1
              }
          ]
      },
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Type": "custom",
          "DefaultSecurityGroupNames": [
              "AWS-OpsWorks-Custom-Server"
          ],
          "Name": "TomCustom",
          "Packages": [],
          "DefaultRecipes": {
              "Undeploy": [],
              "Setup": [
                  "opsworks_initial_setup",
                  "ssh_host_keys",
                  "ssh_users",
                  "mysql::client",
                  "dependencies",
                  "ebs",
                  "opsworks_ganglia::client"
              ],
              "Configure": [
                  "opsworks_ganglia::configure-client",
                  "ssh_users",
                  "agent_version"
              ],
              "Shutdown": [
                  "opsworks_shutdown::default"
              ],
              "Deploy": [
                  "deploy::default"
              ]
          },
          "CustomRecipes": {
              "Undeploy": [],
              "Setup": [
                  "tomcat::setup"
              ],
              "Configure": [
                  "tomcat::configure"
              ],
              "Shutdown": [],
              "Deploy": [
                  "tomcat::deploy"
              ]
          },
          "EnableAutoHealing": true,
          "LayerId": "e6cbcd29-d223-40fc-8243-2eb213377440",
          "Attributes": {
              "MysqlRootPasswordUbiquitous": null,
              "RubygemsVersion": null,
              "RailsStack": null,
              "HaproxyHealthCheckMethod": null,
              "RubyVersion": null,
              "BundlerVersion": null,
              "HaproxyStatsPassword": null,
              "PassengerVersion": null,
              "MemcachedMemory": null,
              "EnableHaproxyStats": null,
              "ManageBundler": null,
              "NodejsVersion": null,
              "HaproxyHealthCheckUrl": null,
              "MysqlRootPassword": null,
              "GangliaPassword": null,
              "GangliaUser": null,
              "HaproxyStatsUrl": null,
              "GangliaUrl": null,
              "HaproxyStatsUser": null
          },
          "Shortname": "tomcustom",
          "AutoAssignElasticIps": false,
          "CustomSecurityGroupIds": [],
          "CreatedAt": "2013-07-25T18:12:53+00:00",
          "VolumeConfigurations": []
      }
  ]
}

Mais informações

Para obter mais informações, consulte Camadas no Guia do usuário do AWS OpsWorks.

Para descrever a configuração de escalabilidade baseada em carga de uma camada

O exemplo a seguir descreve a configuração de escalabilidade baseada em carga da camada especificada. A camada é identificada por seu ID de camada, que pode ser encontrado na página de detalhes da camada ou executando describe-layers.

aws opsworks describe-load-based-auto-scaling --region us-east-1 --layer-ids 6bec29c9-c866-41a0-aba5-fa3e374ce2a1

Saída: a camada de exemplo tem uma única instância baseada em carga.

{
  "LoadBasedAutoScalingConfigurations": [
    {
      "DownScaling": {
        "IgnoreMetricsTime": 10,
        "ThresholdsWaitTime": 10,
        "InstanceCount": 1,
        "CpuThreshold": 30.0
      },
      "Enable": true,
      "UpScaling": {
        "IgnoreMetricsTime": 5,
        "ThresholdsWaitTime": 5,
        "InstanceCount": 1,
        "CpuThreshold": 80.0
      },
      "LayerId": "6bec29c9-c866-41a0-aba5-fa3e374ce2a1"
    }
  ]
}

Mais informações

Para obter mais informações, consulte Como funciona a escalabilidade automática baseada em carga no Guia do usuário do AWS OpsWorks.

Para obter o perfil de um usuário

O exemplo a seguir mostra como obter o perfil do usuário do AWS Identity and Access Management (IAM) que está executando o comando.

aws opsworks --region us-east-1 describe-my-user-profile

Saída: para simplificação, a maior parte da chave pública SSH do usuário é substituída por uma elipse (...).

{
  "UserProfile": {
    "IamUserArn": "arn:aws:iam::123456789012:user/myusername",
    "SshPublicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQ...3LQ4aX9jpxQw== rsa-key-20141104",
    "Name": "myusername",
    "SshUsername": "myusername"
  }
}

Mais informações

Para obter mais informações, consulte Importar usuários para o AWS OpsWorks no Guia do Usuário do AWS OpsWorks.

Para obter o nível de permissão de um usuário do AWS OpsWorks por pilha

O exemplo a seguir mostra como obter o nível de permissão de um usuário do AWS Identity and Access Management (IAM) em uma pilha especificada.

aws opsworks --region us-east-1 describe-permissions --iam-user-arn arn:aws:iam::123456789012:user/cli-user-test --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06

Saída:

{
  "Permissions": [
    {
      "StackId": "d72553d4-8727-448c-9b00-f024f0ba1b06",
      "IamUserArn": "arn:aws:iam::123456789012:user/cli-user-test",
      "Level": "manage",
      "AllowSudo": true,
      "AllowSsh": true
    }
  ]
}

Mais informações

Para obter mais informações, consulte Conceder níveis de permissões por pilha no Guia do usuário do AWS OpsWorks.

Para descrever matrizes RAID

O exemplo a seguir descreve as matrizes RAID conectadas às instâncias em uma pilha especificada.

aws opsworks --region us-east-1 describe-raid-arrays --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06

Saída: esta é a saída para uma pilha com uma matriz RAID.

{
  "RaidArrays": [
    {
      "StackId": "d72553d4-8727-448c-9b00-f024f0ba1b06",
      "AvailabilityZone": "us-west-2a",
      "Name": "Created for php-app1",
      "NumberOfDisks": 2,
      "InstanceId": "9f14adbc-ced5-43b6-bf01-e7d0db6cf2f7",
      "RaidLevel": 0,
      "VolumeType": "standard",
      "RaidArrayId": "f2d4e470-5972-4676-b1b8-bae41ec3e51c",
      "Device": "/dev/md0",
      "MountPoint": "/mnt/workspace",
      "CreatedAt": "2015-02-26T23:53:09+00:00",
      "Size": 100
    }
  ]
}

Para obter mais informações, consulte Volumes EBS no Guia do usuário do AWS OpsWorks.

Para descrever as instâncias registradas do Amazon RDS de uma pilha

O exemplo a seguir descreve as instâncias do Amazon RDS registradas com uma pilha especificada.

aws opsworks --region us-east-1 describe-rds-db-instances --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06

Saída: esta é a saída de uma pilha com uma instância RDS registrada.

{
  "RdsDbInstances": [
    {
      "Engine": "mysql",
      "StackId": "d72553d4-8727-448c-9b00-f024f0ba1b06",
      "MissingOnRds": false,
      "Region": "us-west-2",
      "RdsDbInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:clitestdb",
      "DbPassword": "*****FILTERED*****",
      "Address": "clitestdb.cdlqlk5uwd0k.us-west-2.rds.amazonaws.com",
      "DbUser": "cliuser",
      "DbInstanceIdentifier": "clitestdb"
    }
  ]
}

Para obter mais informações, consulte Gerenciamento de recursos no Guia do usuário do AWS OpsWorks.

Como retornar os parâmetros de provisionamento de uma pilha

O exemplo describe-stack-provisioning-parameters a seguir retorna os parâmetros de provisionamento de uma pilha especificada. Os parâmetros de provisionamento incluem configurações como o local de instalação do agente e a chave pública que o OpsWorks usa para gerenciar o agente em instâncias em uma pilha.

aws opsworks describe-stack-provisioning-parameters \
    --stack-id 62744d97-6faf-4ecb-969b-a086fEXAMPLE

Saída:

{
    "AgentInstallerUrl": "https://opsworks-instance-agent-us-west-2.s3.amazonaws.com/ID_number/opsworks-agent-installer.tgz",
    "Parameters": {
        "agent_installer_base_url": "https://opsworks-instance-agent-us-west-2.s3.amazonaws.com",
        "agent_installer_tgz": "opsworks-agent-installer.tgz",
        "assets_download_bucket": "opsworks-instance-assets-us-west-2.s3.amazonaws.com",
        "charlie_public_key": "-----BEGIN PUBLIC KEY-----PUBLIC_KEY_EXAMPLE\n-----END PUBLIC KEY-----",
        "instance_service_endpoint": "opsworks-instance-service.us-west-2.amazonaws.com",
        "instance_service_port": "443",
        "instance_service_region": "us-west-2",
        "instance_service_ssl_verify_peer": "true",
        "instance_service_use_ssl": "true",
        "ops_works_endpoint": "opsworks.us-west-2.amazonaws.com",
        "ops_works_port": "443",
        "ops_works_region": "us-west-2",
        "ops_works_ssl_verify_peer": "true",
        "ops_works_use_ssl": "true",
        "verbose": "false",
        "wait_between_runs": "30"
    }
}

Para obter mais informações, consulte Comandos de execução da pilha no Guia do usuário do AWS OpsWorks.

Para descrever a configuração de uma pilha

O comando describe-stack-summary a seguir retorna um resumo da configuração da pilha especificada.

aws opsworks --region us-east-1 describe-stack-summary --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Saída:

{
  "StackSummary": {
    "StackId": "8c428b08-a1a1-46ce-a5f8-feddc43771b8",
    "InstancesCount": {
      "Booting": 1
    },
    "Name": "CLITest",
    "AppsCount": 1,
    "LayersCount": 1,
    "Arn": "arn:aws:opsworks:us-west-2:123456789012:stack/8c428b08-a1a1-46ce-a5f8-feddc43771b8/"
  }
}

Mais informações

Para obter mais informações, consulte Pilhas no Guia do usuário do AWS OpsWorks.

Para descrever pilhas

O seguinte comando de describe-stacks descreve as pilhas de uma conta.

aws opsworks --region us-east-1 describe-stacks

Saída:

{
  "Stacks": [
    {
      "ServiceRoleArn": "arn:aws:iam::444455556666:role/aws-opsworks-service-role",
      "StackId": "aeb7523e-7c8b-49d4-b866-03aae9d4fbcb",
      "DefaultRootDeviceType": "instance-store",
      "Name": "TomStack-sd",
      "ConfigurationManager": {
        "Version": "11.4",
        "Name": "Chef"
      },
      "UseCustomCookbooks": true,
      "CustomJson": "{\n  \"tomcat\": {\n    \"base_version\": 7,\n    \"java_opts\": \"-Djava.awt.headless=true -Xmx256m\"\n  },\n  \"datasources\": {\n    \"ROOT\": \"jdbc/mydb\"\n  }\n}",
      "Region": "us-east-1",
      "DefaultInstanceProfileArn": "arn:aws:iam::444455556666:instance-profile/aws-opsworks-ec2-role",
      "CustomCookbooksSource": {
        "Url": "git://github.com/example-repo/tomcustom.git",
        "Type": "git"
      },
      "DefaultAvailabilityZone": "us-east-1a",
      "HostnameTheme": "Layer_Dependent",
      "Attributes": {
        "Color": "rgb(45, 114, 184)"
      },
      "DefaultOs": "Amazon Linux",
      "CreatedAt": "2013-08-01T22:53:42+00:00"
    },
    {
      "ServiceRoleArn": "arn:aws:iam::444455556666:role/aws-opsworks-service-role",
      "StackId": "40738975-da59-4c5b-9789-3e422f2cf099",
      "DefaultRootDeviceType": "instance-store",
      "Name": "MyStack",
      "ConfigurationManager": {
        "Version": "11.4",
        "Name": "Chef"
      },
      "UseCustomCookbooks": false,
      "Region": "us-east-1",
      "DefaultInstanceProfileArn": "arn:aws:iam::444455556666:instance-profile/aws-opsworks-ec2-role",
      "CustomCookbooksSource": {},
      "DefaultAvailabilityZone": "us-east-1a",
      "HostnameTheme": "Layer_Dependent",
      "Attributes": {
        "Color": "rgb(45, 114, 184)"
      },
      "DefaultOs": "Amazon Linux",
      "CreatedAt": "2013-10-25T19:24:30+00:00"
    }
  ]
}

Mais informações

Para obter mais informações, consulte Pilhas no Guia do usuário do AWS OpsWorks.

Para descrever a configuração de escalabilidade baseada em tempo de uma instância

O exemplo a seguir descreve a configuração de escalabilidade baseada em tempo da instância especificada. A instância é identificada por seu ID de instância, que pode ser encontrado na página de detalhes da instância ou executando describe-instances.

aws opsworks describe-time-based-auto-scaling --region us-east-1 --instance-ids 701f2ffe-5d8e-4187-b140-77b75f55de8d

Saída: o exemplo tem uma única instância baseada em tempo.

{
  "TimeBasedAutoScalingConfigurations": [
   {
      "InstanceId": "701f2ffe-5d8e-4187-b140-77b75f55de8d",
      "AutoScalingSchedule": {
        "Monday": {
          "11": "on",
          "10": "on",
          "13": "on",
          "12": "on"
        },
        "Tuesday": {
          "11": "on",
          "10": "on",
          "13": "on",
          "12": "on"
        }
      }
    }
  ]
}

Mais informações

Para obter mais informações, consulte Como funciona a escalabilidade automática baseada em tempo no Guia do usuário do AWS OpsWorks.

Para descrever perfis de usuário

O comando describe-user-profiles a seguir descreve os perfis de usuário da conta.

aws opsworks --region us-east-1 describe-user-profiles

Saída:

{
  "UserProfiles": [
    {
      "IamUserArn": "arn:aws:iam::123456789012:user/someuser",
      "SshPublicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQEAkOuP7i80q3Cko...",
      "AllowSelfManagement": true,
      "Name": "someuser",
      "SshUsername": "someuser"
    },
    {
      "IamUserArn": "arn:aws:iam::123456789012:user/cli-user-test",
      "AllowSelfManagement": true,
      "Name": "cli-user-test",
      "SshUsername": "myusername"
    }
  ]
}

Mais informações

Para obter mais informações, consulte Gerenciar usuários do AWS OpsWorks no Guia do Usuário do AWS OpsWorks.

Para descrever os volumes de uma pilha

O exemplo a seguir descreve os volumes EBS de uma pilha.

aws opsworks --region us-east-1 describe-volumes --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Saída:

{
  "Volumes": [
    {
      "Status": "in-use",
      "AvailabilityZone": "us-west-2a",
      "Name": "CLITest",
      "InstanceId": "dfe18b02-5327-493d-91a4-c5c0c448927f",
      "VolumeType": "standard",
      "VolumeId": "56b66fbd-e1a1-4aff-9227-70f77118d4c5",
      "Device": "/dev/sdi",
      "Ec2VolumeId": "vol-295c1638",
      "MountPoint": "/mnt/myvolume",
      "Size": 1
    }
  ]
}

Mais informações

Para obter mais informações, consulte Gerenciamento de recursos no Guia do usuário do AWS OpsWorks.

Como desvincular um balanceador de carga de uma camada

O exemplo a seguir desvincula um balanceador de carga, identificado por seu nome, de sua camada.

aws opsworks --region us-east-1 detach-elastic-load-balancer --elastic-load-balancer-name Java-LB --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Balanceamento de carga elástico no Manual do usuário do AWS OpsWorks.

Como desassociar um endereço IP elástico de uma instância

O exemplo a seguir desassocia o endereço IP elástico da instância especificada.

aws opsworks --region us-east-1 disassociate-elastic-ip --elastic-ip 54.148.130.96

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Gerenciamento de recursos no Guia do usuário do AWS OpsWorks.

Para obter o próximo nome de host para uma camada

O exemplo a seguir obtém o próximo nome de host gerado para uma camada especificada. A camada usada neste exemplo é uma camada do Java Application Server com uma instância. O tema do nome de host da pilha é o padrão, Layer_Dependent.

aws opsworks --region us-east-1 get-hostname-suggestion --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4

Saída:

{
  "Hostname": "java-app2",
  "LayerId": "888c5645-09a5-4d0e-95a8-812ef1db76a4"
}

Mais informações

Para obter mais informações, consulte Criar uma nova pilha no Guia do usuário do AWS OpsWorks.

Como reinicializar uma instância

O exemplo a seguir reinicia uma instância.

aws opsworks --region us-east-1 reboot-instance --instance-id dfe18b02-5327-493d-91a4-c5c0c448927f

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Reinicializar uma instância no Guia do usuário do AWS OpsWorks.

Para registrar endereços IP elásticos em uma pilha

O exemplo a seguir registra de um endereço IP elástico, identificado por seu endereço IP, com uma pilha especificada.

Observação: o endereço IP elástico deve estar na mesma região da pilha.

aws opsworks register-elastic-ip --region us-east-1 --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06 --elastic-ip 54.148.130.96

Saída

{
  "ElasticIp": "54.148.130.96"
}

Mais informações

Para obter mais informações, consulte Registrar endereços IP elásticos em uma pilha no Guia do usuário do OpsWorks.

Para registrar uma instância do Amazon RDS em uma pilha

O exemplo a seguir registra uma instância de banco de dados do Amazon RDS, identificada por seu nome do recurso da Amazon (ARN), na pilha especificada. Ele também especifica o nome de usuário e a senha mestre da instância. Observe que o AWS OpsWorks não valida nenhum desses valores. Se um deles estiver incorreto, sua aplicação não poderá se conectar ao banco de dados.

aws opsworks register-rds-db-instance --region us-east-1 --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06 --rds-db-instance-arn arn:aws:rds:us-west-2:123456789012:db:clitestdb  --db-user cliuser --db-password some23!pwd

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Registrar instâncias do Amazon RDS em uma pilha no Guia do usuário do AWS OpsWorks.

Para registrar volumes Amazon EBS em uma pilha

O exemplo a seguir registra um volume do Amazon EBS, identificado por seu ID de volume, em pilha especificada.

aws opsworks register-volume --region us-east-1 --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06 --ec-2-volume-id vol-295c1638

Saída:

{
  "VolumeId": "ee08039c-7cb7-469f-be10-40fb7f0c05e8"
}

Mais informações

Para obter mais informações, consulte Registrar volumes do Amazon EBS em uma pilha no Guia do usuário do AWS OpsWorks User Guide.

Para registrar instâncias em uma pilha

O exemplo a seguir mostra uma variedade de maneiras de registrar instâncias em uma pilha que foi criada fora do AWS Opsworks. É possível executar register partir da instância a ser registrada ou de uma estação de trabalho separada. Para obter mais informações, consulte Registrar instâncias do Amazon EC2 e On-premises no Guia do usuário do AWS OpsWorks.

Observação: para simplificação, os exemplos omitem o argumento region.

Para registrar uma instância do Amazon EC2

Para indicar que uma instância do EC2 está sendo registrada, defina o argumento --infrastructure-class como ec2.

O exemplo a seguir registra uma instância do EC2 na pilha especificada a partir de uma estação de trabalho separada. A instância é identificada por seu ID do EC2, i-12345678. O exemplo usa o nome de usuário SSH padrão da estação de trabalho e tenta fazer login na instância usando técnicas de autenticação que não exigem uma senha, como uma chave SSH privada padrão. Se isso falhar, register solicita a senha.

aws opsworks register --infrastructure-class=ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb i-12345678

O exemplo a seguir registra uma instância do EC2 na pilha especificada a partir de uma estação de trabalho separada. Ele usa os argumentos --ssh-username e --ssh-private-key para especificar explicitamente o nome de usuário SSH e o arquivo de chave privada que o comando usa para fazer login na instância. ec2-user é o nome de usuário padrão para instâncias do Amazon Linux. Use ubuntu para instâncias do Ubuntu.

aws opsworks register --infrastructure-class=ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --ssh-username ec2-user --ssh-private-key ssh_private_key i-12345678

O exemplo a seguir registra a instância do EC2 que está executando o comando register. Faça login na instância com SSH e execute register com o argumento --local em vez de um ID de instância ou nome de host.

aws opsworks register --infrastructure-class ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --local

Para registrar uma instância on-premises

Para indicar que uma instância on-premises está sendo registrada, defina o argumento --infrastructure-class como on-premises.

O exemplo a seguir registra uma instância on-premises existente em uma pilha especificada a partir de uma estação de trabalho separada. A instância é identificada por seu endereço IP, 192.0.2.3. O exemplo usa o nome de usuário SSH padrão da estação de trabalho e tenta fazer login na instância usando técnicas de autenticação que não exigem uma senha, como uma chave SSH privada padrão. Se isso falhar, register solicita a senha.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb 192.0.2.3

O exemplo a seguir registra uma instância on-premises em uma pilha especificada a partir de uma estação de trabalho separada. A instância é identificada pelo nome de host, host1. Os argumentos --override-... orientam o AWS OpsWorks a exibir webserver1 como nome do host e 192.0.2.3 e 10.0.0.2 como endereços IP públicos e privados da instância, respectivamente.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --override-hostname webserver1 --override-public-ip 192.0.2.3 --override-private-ip 10.0.0.2 host1

O exemplo a seguir registra uma instância on-premises em uma pilha especificada a partir de uma estação de trabalho separada. A instância é identificada por seu endereço IP. register faz login na instância usando o nome de usuário SSH e o arquivo de chave privada especificados.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --ssh-username admin --ssh-private-key ssh_private_key 192.0.2.3

O exemplo a seguir registra uma instância on-premises existente em uma pilha especificada a partir de uma estação de trabalho separada. O comando faz login na instância usando uma string de comando SSH personalizada que especifica a senha SSH e o endereço IP da instância.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --override-ssh "sshpass -p 'mypassword' ssh your-user@192.0.2.3"

O exemplo a seguir registra a instância on-premises que está executando o comando register. Faça login na instância com SSH e execute register com o argumento --local em vez de um ID de instância ou nome de host.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --local

Saída: esta é uma saída típica para registrar uma instância do EC2.

Warning: Permanently added '52.11.41.206' (ECDSA) to the list of known hosts.
% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                               Dload  Upload   Total   Spent    Left  Speed
100 6403k  100 6403k    0     0  2121k      0  0:00:03  0:00:03 --:--:-- 2121k
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Initializing AWS OpsWorks environment
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Running on Ubuntu
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Checking if OS is supported
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Running on supported OS
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Setup motd
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing: ln -sf --backup /etc/motd.opsworks-static /etc/motd
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Enabling multiverse repositories
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Customizing APT environment
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Installing system packages
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing: dpkg --configure -a
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing with retry: apt-get update
[Tue, 24 Feb 2015 20:49:13 +0000] opsworks-init: Executing: apt-get install -y ruby ruby-dev libicu-dev libssl-dev libxslt-dev libxml2-dev libyaml-dev monit
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Using assets bucket from environment: 'opsworks-instance-assets-us-east-1.s3.amazonaws.com'.
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Installing Ruby for the agent
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Executing: /tmp/opsworks-agent-installer.YgGq8wF3UUre6yDy/opsworks-agent-installer/opsworks-agent/bin/installer_wrapper.sh -r -R opsworks-instance-assets-us-east-1.s3.amazonaws.com
[Tue, 24 Feb 2015 20:50:44 +0000] opsworks-init: Starting the installer
Instance successfully registered. Instance ID: 4d6d1710-ded9-42a1-b08e-b043ad7af1e2
Connection to 52.11.41.206 closed.

Mais informações

Para obter mais informações, consulte Registrar uma instância em uma pilha do AWS OpsWorks no Guia do usuário do AWS OpsWorks.

Como definir a configuração de escalabilidade baseada em carga para uma camada

O exemplo a seguir habilita o ajuste de escala baseado em carga para uma camada especificada e define a configuração dessa camada. É necessário usar create-instance para adicionar instâncias baseadas em carga à camada.

aws opsworks --region us-east-1 set-load-based-auto-scaling --layer-id 523569ae-2faf-47ac-b39e-f4c4b381f36d --enable --up-scaling file://upscale.json --down-scaling file://downscale.json

O exemplo coloca as configurações de limite de aumento de escala em um arquivo separado no diretório de trabalho chamado upscale.json, que contém o seguinte.

{
  "InstanceCount": 2,
  "ThresholdsWaitTime": 3,
  "IgnoreMetricsTime": 3,
  "CpuThreshold": 85,
  "MemoryThreshold": 85,
  "LoadThreshold": 85
}

O exemplo coloca as configurações de limite de diminuição de escala em um arquivo separado no diretório de trabalho chamado downscale.json, que contém o seguinte.

{
"InstanceCount": 2,
"ThresholdsWaitTime": 3,
"IgnoreMetricsTime": 3,
"CpuThreshold": 35,
"MemoryThreshold": 30,
"LoadThreshold": 30
}

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Utilizar a escalabilidade automática baseada em carga no Guia do usuário do AWS OpsWorks.

Como conceder níveis de permissão do AWS OpsWorks por pilha

Ao importar um usuário do AWS Identity and Access Management (IAM) para o AWS OpsWorks chamando create-user-profile, o usuário tem somente as permissões concedidas pelas políticas do IAM anexadas. É possível conceder permissões do AWS OpsWorks modificando as políticas de um usuário. No entanto, geralmente é mais fácil importar um usuário e depois usar o comando set-permission para conceder ao usuário um dos níveis de permissão padrão para cada pilha à qual o usuário precisará acessar.

O exemplo a seguir concede permissão para a pilha especificada para um usuário, identificado pelo nome do recurso da Amazon (ARN). O exemplo concede ao usuário um nível de permissões de gerenciamento, com privilégios sudo e SSH nas instâncias da pilha.

aws opsworks set-permission --region us-east-1 --stack-id 71c7ca72-55ae-4b6a-8ee1-a8dcded3fa0f --level manage  --iam-user-arn arn:aws:iam::123456789102:user/cli-user-test --allow-ssh --allow-sudo

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Conceder níveis de permissões do AWS OpsWorks por pilha no Guia do usuário do AWS OpsWorks.

Como definir a configuração de escalabilidade baseada em tempo para uma camada

O exemplo a seguir descreve a configuração de escalabilidade baseada em tempo para a instância especificada. É necessário primeiro usar create-instance para adicionar a instância à camada.

aws opsworks --region us-east-1 set-time-based-auto-scaling --instance-id 69b6237c-08c0-4edb-a6af-78f3d01cedf2 --auto-scaling-schedule file://schedule.json

O exemplo coloca a agenda em um arquivo separado no diretório de trabalho chamado schedule.json. Neste exemplo, a instância fica ativa por algumas horas por volta do meio-dia UTC (Horário Universal Coordenado) na segunda e na terça-feira.

{
  "Monday": {
    "10": "on",
    "11": "on",
    "12": "on",
    "13": "on"
  },
  "Tuesday": {
    "10": "on",
    "11": "on",
    "12": "on",
    "13": "on"
  }
}

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Utilizar a escalabilidade automática baseada em tempo no Guia do usuário do AWS OpsWorks.

Para iniciar uma instância

O comando start-instance a seguir inicia uma instância específica 24 horas por dia, 7 dias por semana.

aws opsworks start-instance --instance-id f705ee48-9000-4890-8bd3-20eb05825aaf

Saída: nenhuma. Use describe-instances para verificar o status da instância.

Dica É possível iniciar cada instância offline em uma pilha com um comando chamando start-stack.

Mais informações

Para obter mais informações, consulte Inicializar, interromper e reinicializar instâncias 24/7 manualmente no Guia do usuário do AWS OpsWorks.

Para iniciar as instâncias de uma pilha

O exemplo a seguir inicia todas as instâncias 24 horas por dia, 7 dias por semana de uma pilha. Para iniciar uma instância específica, use start-instance.

aws opsworks --region us-east-1 start-stack --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Inicializar uma instância no Guia do usuário do AWS OpsWorks.

Como interromper uma instância

O exemplo a seguir interrompe uma instância especificada, identificada pelo ID da instância. Você pode obter um ID de instância acessando a página de detalhes da instância no console do AWS OpsWorks ou executando o comando describe-instances.

aws opsworks stop-instance --region us-east-1 --instance-id 3a21cfac-4a1f-4ce2-a921-b2cfba6f7771

É possível reiniciar uma instância interrompida chamando start-instance ou excluindo a instância chamando delete-instance.

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Interromper uma instância no Guia do usuário do AWS OpsWorks.

Como interromper as instâncias de uma pilha

O exemplo a seguir interrompe todas as instâncias 24 horas por dia, 7 dias por semana de uma pilha. Para interromper uma instância específica, use stop-instance.

aws opsworks --region us-east-1 stop-stack --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Saída: não há saída.

Mais informações

Para obter mais informações, consulte Interromper uma instância no Guia do usuário do AWS OpsWorks.

Como cancelar a atribuição de uma instância registrada em suas camadas

O comando unassign-instance a seguir cancela a atribuição de uma instância de suas camadas anexadas.

aws opsworks --region us-east-1 unassign-instance --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Cancelar a atribuição de uma instância registrada no Guia do usuário do AWS OpsWorks.

Como cancelar a atribuição de um volume de sua instância

O exemplo a seguir atribui um volume registrado do Amazon Elastic Block Store (Amazon EBS) de uma instância. O volume é identificado pelo ID do volume, que é o GUID que o AWS OpsWorks atribui quando é feito o registro do volume em uma pilha, não pelo ID do volume do Amazon Elastic Compute Cloud (Amazon EC2).

aws opsworks --region us-east-1 unassign-volume --volume-id 8430177d-52b7-4948-9c62-e195af4703df

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Cancelar a atribuição de volumes Amazon EBS no Guia do usuário do AWS OpsWorks.

Para atualizar uma aplicação

O exemplo a seguir atualiza uma aplicação especificada para alterar seu nome.

aws opsworks --region us-east-1 update-app --app-id 26a61ead-d201-47e3-b55c-2a7c666942f8 --name NewAppName

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Editar aplicações no Guia do usuário do AWS OpsWorks.

Para atualizar um nome de endereço IP elástico

O exemplo a seguir atualiza o nome de um endereço IP elástico especificado.

aws opsworks --region us-east-1 update-elastic-ip --elastic-ip 54.148.130.96 --name NewIPName

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Gerenciamento de recursos no Guia do usuário do AWS OpsWorks.

Para atualizar uma instância

O exemplo a seguir atualiza o tipo de uma instância especificada.

aws opsworks --region us-east-1 update-instance --instance-id dfe18b02-5327-493d-91a4-c5c0c448927f --instance-type c3.xlarge

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Editar a configuração da instância no Guia do usuário do AWS OpsWorks.

Para atualizar uma camada

O exemplo a seguir atualiza uma camada especificada para usar instâncias otimizadas para o Amazon EBS.

aws opsworks --region us-east-1 update-layer --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4 --use-ebs-optimized-instances

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Editar uma configuração de camada do OpsWorks no Guia do usuário do AWS OpsWorks.

Para atualizar um perfil de usuário

O exemplo a seguir atualiza o perfil do usuário development para usar uma chave pública SSH especificada. As credenciais do usuário AWS são representadas pelo perfil development no arquivo credentials (~\.aws\credentials) e a chave está em um .pem arquivo no diretório de trabalho.

aws opsworks --region us-east-1 --profile development update-my-user-profile --ssh-public-key file://development_key.pem

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Editar as definições de usuários do AWS OpsWorks no Guia do Usuário do AWS OpsWorks.

Para atualizar uma instância registrada do banco de dados Amazon RDS

O exemplo a seguir atualiza o valor da senha mestra de uma instância do Amazon RDS. Observe que esse comando não altera a senha mestra da instância do RDS, apenas a senha fornecida ao AWS OpsWorks. Se essa senha não corresponder à senha da instância do RDS, sua aplicação não conseguirá se conectar ao banco de dados.

aws opsworks --region us-east-1 update-rds-db-instance --db-password 123456789

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Registrar instâncias do Amazon RDS em uma pilha no Guia do usuário do AWS OpsWorks.

Para atualizar um volume registrado

O exemplo a seguir atualiza o ponto de montagem de um volume registrado do Amazon Elastic Block Store (Amazon EBS). O volume é identificado pelo ID do volume, que é o GUID que o AWS OpsWorks atribui ao volume quando você o registra em uma pilha, não pelo ID do volume do Amazon Elastic Compute Cloud (Amazon EC2):

aws opsworks --region us-east-1 update-volume --volume-id 8430177d-52b7-4948-9c62-e195af4703df --mount-point /mnt/myvol

Saída: nenhuma.

Mais informações

Para obter mais informações, consulte Atribuir volumes do Amazon EBS a uma instância no Guia do usuário do AWS OpsWorks.