Introdução
Uma equipe de relatórios executa sua aplicação em duas localidades. Cada localidade precisa de seu próprio rótulo de serviço, embora a configuração tenha o mesmo nome. Você criará as duas configurações, comparará ambas, alterará um valor e excluirá apenas seus recursos de prática.
Conclua primeiro Primeiros passos com AWS no LabEx. Aqui, você usará os fundamentos de Terminal, AWS CLI, identidade, parâmetros e AWS View desse laboratório. Este laboratório começa de forma independente: as ferramentas e a conexão estão prontas, e nenhum arquivo, recurso ou credencial anterior é reutilizado.
Parameter Store armazena configurações com nome. Seu /labex/onboarding/service-label será um String comum, não um segredo. Cada região já contém um parâmetro /labex/reference/team sem relação com a tarefa; preserve-o. AWS View mostra os mesmos recursos que você consulta pela CLI.
Relação com as certificações
Este laboratório oferece prática nos seguintes tópicos de exame.
- Cloud Practitioner (CLF-C02) · Tarefa 3.2: Regiões, escopo regional e identidade dos recursos.
- Solutions Architect – Associate (SAA-C03) · Tarefa 1.1: Regiões, escopo regional e identidade dos recursos.
Crie seu primeiro recurso regional
Nesta etapa, você criará uma configuração de aplicação na região leste e a verá aparecer no AWS View.
Clique em Terminal e vá ao espaço de trabalho preparado:
cd /home/labex/project
No laboratório anterior, todas as solicitações usavam uma localidade. Uma equipe pode executar aplicações perto de usuários em diferentes partes do mundo, portanto você precisa escolher qual localidade um comando afeta. Uma região AWS é uma área geográfica onde os serviços são executados. us-east-1 é o código de US East (N. Virginia); us-west-2 corresponde a US West (Oregon). A opção --region escolhe onde esta solicitação atua. Sua primeira configuração ficará em us-east-1.
Diagrama conceitual: as configurações pertencem a regiões diferentes. Criar uma não a copia para a outra.
Crie-a:
aws ssm put-parameter --name /labex/onboarding/service-label --type String --value finance-east --region us-east-1
ssm seleciona Systems Manager, e put-parameter grava uma configuração. --name fornece o nome do recurso, --type String significa texto comum e --value fornece esse texto. As barras organizam um nome na AWS; elas não criam pastas locais.
A resposta inclui "Version": 1. Você criou a primeira versão. Leia a configuração novamente:
aws ssm get-parameter --name /labex/onboarding/service-label --region us-east-1
Encontre Name, Value e Version em Parameter: o nome termina em service-label, o valor é finance-east e a versão é 1.
Clique em AWS View, ao lado de Terminal. Siga Terminal → Parameter Store → os cartões das regiões. Em us-east-1, encontre o novo parâmetro e compare seu valor com a resposta da CLI. O cartão de us-west-2 tem apenas o parâmetro de referência. Este recurso foi criado em uma região; ele não foi copiado para a outra.
A verificação de conclusão lê sua configuração do leste. Mantenha os parâmetros de referência inalterados.
Crie o mesmo nome em outra região
Nesta etapa, você criará o mesmo nome de parâmetro em uma segunda região e observará que os dois recursos permanecem independentes.
Na Console oficial, o menu Region escolhe qual localidade você visualiza. Seus nomes e códigos correspondem à opção --region da CLI:
Fonte: Guia da AWS Console.
Agora crie o rótulo da aplicação do oeste. Ele usa o mesmo nome de antes, mas uma --region e um valor diferentes:
aws ssm put-parameter --name /labex/onboarding/service-label --type String --value finance-west --region us-west-2
A resposta contém novamente "Version": 1. Este é um novo recurso no oeste, não a versão 2 do recurso do leste.
Leia cada valor armazenado. get-parameter solicita ao serviço um recurso com nome:
aws ssm get-parameter --name /labex/onboarding/service-label --region us-east-1
aws ssm get-parameter --name /labex/onboarding/service-label --region us-west-2
Ambas as respostas contêm um objeto Parameter com Name, Type, Value, Version e ARN. Compare os valores: o leste retorna finance-east, e o oeste retorna finance-west. O nome é o mesmo. Um ARN é um identificador completo de recurso; por enquanto, observe us-east-1 em um e us-west-2 no outro. A próxima etapa explica as demais partes. AWS View mostra os dois cartões de região separados. Um recurso aparecer em uma região não significa que ele exista em outra.
Este exemplo mostra os recursos do leste e do oeste juntos. Os identificadores de conta e os valores são exemplos; use os campos reais retornados pelas suas consultas.
Leia a identidade do recurso e altere apenas o valor
Nesta etapa, você interpretará o ARN de um recurso e atualizará a configuração do leste sem alterar sua identidade nem o valor do oeste.
Um Amazon Resource Name (ARN) identifica um recurso. No AWS View, encontre o ARN abaixo da sua configuração do leste. Para este parâmetro, ele tem este formato:
arn:aws:ssm:us-east-1:ACCOUNT_ID:parameter/labex/onboarding/service-label
Leia apenas as partes necessárias para identificar este parâmetro; você não precisa memorizar o formato.
Por enquanto, encontre o serviço (ssm), a região (us-east-1), o ID da conta e o nome do parâmetro. Compare o ARN do oeste: sua região é diferente, embora o nome seja o mesmo. O ARN de quem faz a chamada, que você viu no laboratório de preparação, identifica um usuário; este ARN identifica um recurso de configuração. Você não precisa memorizar formatos de ARN.
Leia a configuração do leste antes de alterá-la:
aws ssm get-parameter --name /labex/onboarding/service-label --region us-east-1
O nome é /labex/onboarding/service-label; o valor é finance-east. Eles respondem a perguntas diferentes: qual configuração você está lendo e quais dados ela contém? Alterar dados não renomeia nem move o recurso por si só. Normalmente, put-parameter recusa a substituição acidental de um parâmetro existente; adicionar --overwrite permite explicitamente atualizar o valor. Atualize apenas o leste:
aws ssm put-parameter --name /labex/onboarding/service-label --type String --value finance-east-reviewed --overwrite --region us-east-1
A resposta inclui "Version": 2. Leia ambos os recursos:
aws ssm get-parameter --name /labex/onboarding/service-label --region us-east-1
aws ssm get-parameter --name /labex/onboarding/service-label --region us-west-2
O valor do leste agora é finance-east-reviewed e sua Version é 2, enquanto seu ARN permanece inalterado. O oeste ainda retorna finance-west na Version 1. Confira esses campos nas duas respostas JSON e no AWS View. Essa distinção ajuda a diagnosticar erros depois: o nome correto na região errada identifica outro recurso, e um valor atualizado ainda pode pertencer ao mesmo recurso.
O rótulo do leste foi revisado na Version 2, enquanto o rótulo do oeste permanece na Version 1. Ambos os parâmetros de referência continuam presentes.
Limpe apenas os recursos de onboarding
Nesta etapa, você removerá os dois parâmetros que criou e confirmará que o inventário de referência permanece intacto.
A limpeza deve usar os nomes e as regiões dos recursos que pertencem à sua tarefa. delete-parameter remove o parâmetro com o nome indicado. Uma chamada bem-sucedida pode não exibir nada; o silêncio, por si só, não comprova que você consultou a região correta depois.
aws ssm delete-parameter --name /labex/onboarding/service-label --region us-east-1
aws ssm delete-parameter --name /labex/onboarding/service-label --region us-west-2
describe-parameters lista metadados dos parâmetros na região selecionada, incluindo nomes e versões. Ele não retorna seus valores. Consulte ambas as regiões com sucesso:
aws ssm describe-parameters --region us-east-1
aws ssm describe-parameters --region us-west-2
Seu /labex/onboarding/service-label está ausente de ambas as listas. O /labex/reference/team preparado ainda aparece. Leia essa referência nas duas regiões para confirmar que seu valor permanece inalterado:
aws ssm get-parameter --name /labex/reference/team --region us-east-1
aws ssm get-parameter --name /labex/reference/team --region us-west-2
Ambas retornam platform. AWS View agora mostra apenas o parâmetro de referência em cada região. Não exclua o inventário de referência. Erros de conexão ou autenticação não comprovam a limpeza; a verificação de conclusão exige consultas bem-sucedidas ao serviço e dados de referência preservados.
Resumo
Você criou o mesmo nome de parâmetro em duas regiões, leu valores e ARNs diferentes, alterou apenas o valor do leste e limpou seus dois recursos preservando as referências. AWS View tornou essas mudanças do serviço visíveis ao lado dos resultados da CLI. A seguir, use consultas da CLI para encontrar os recursos de que precisa em um inventário maior.
