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á. # Usando o Amazon EKS Anywhere on AWS Snow O Amazon EKS Anywhere on AWS Snow ajuda você a criar e operar clusters Kubernetes no Snowball Edge. O Kubernetes é um software de código aberto usado para automatizar a implantação, a escalabilidade e o gerenciamento de aplicações em contêineres. Você pode usar o Amazon EKS Anywhere em um dispositivo Snowball Edge com ou sem uma conexão de rede externa. Para usar o Amazon EKS Anywhere em um dispositivo sem uma conexão de rede externa, forneça um registro de contêiner para ser executado no dispositivo Snowball Edge. Para obter informações gerais sobre o Amazon EKS Anywhere, consulte a [documentação do Amazon EKS Anywhere](https://anywhere.eks.amazonaws.com/docs/). O uso do Amazon EKS Anywhere on AWS Snow fornece os seguintes recursos: + Provisione um cluster Kubernetes (K8s) com o CLI do Amazon EKS Anywhere (eksctl anywhere) em dispositivos do Snowball Edge otimizado para computação. Você pode provisionar o Amazon EKS Anywhere em um único dispositivo Snowball Edge ou em três ou mais dispositivos para obter alta disponibilidade. + Suporte para Cilium Container Network Interface (CNI). + Support para Ubuntu 20.04 como sistema operacional de nó. Esse diagrama ilustra um cluster do Amazon EKS Anywhere implantado em um dispositivo Snowball Edge. ![\[Diagrama que mostra o cluster Amazon EKS Anywhere on AWS Snow implantado em um dispositivo Snowball Edge e as relações entre os componentes.\]](http://docs.aws.amazon.com/pt_br/snowball/latest/developer-guide/images/eskaarch.jpg) Recomendamos que você crie o cluster do Kubernetes com a versão mais recente disponível e aceita no Amazon EKS Anywhere. Para ter mais informações, consulte [Amazon EKS-Anywhere Versioning](https://anywhere.eks.amazonaws.com/docs/concepts/support-versions/). Se a aplicação exigir uma versão específica do Kubernetes, use qualquer versão do Kubernetes oferecida no suporte padrão ou estendido do Amazon EKS. Pense nas datas de lançamento e de suporte das versões do Kubernetes ao planejar o ciclo de vida da implantação. Isso ajudará você a evitar a possível perda de suporte da versão do Kubernetes a ser utilizada. Para ter mais informações, consulte [Calendário de lançamento do Amazon EKS Kubernetes](https://docs.aws.amazon.com/eks/latest/userguide/kubernetes-versions.html#kubernetes-release-calendar). Para obter mais informações sobre o Amazon EKS Anywhere on AWS Snow, consulte a [documentação do Amazon EKS Anywhere](https://anywhere.eks.amazonaws.com/docs/). **Topics** + [Ações a serem concluídas antes de comprar um dispositivo Snowball Edge para o Amazon EKS Anywhere on Snow AWS](eksa-gettingstarted.md) + [Solicitando um dispositivo Snowball Edge para uso com o Amazon EKS Anywhere on Snow AWS](order-sbe.md) + [Configuração e execução do Amazon EKS Anywhere em dispositivos Snowball Edge](eksa-configuration.md) + [Configuração do Amazon EKS Anywhere on AWS Snow para operação desconectada](configure-disconnected.md) + [Criar clusters e realizar a manutenção deles em dispositivos Snowball Edge](maintain-eks-a-clusters-snow.md) # Ações a serem concluídas antes de comprar um dispositivo Snowball Edge para o Amazon EKS Anywhere on Snow AWS No momento, o Amazon EKS Anywhere é compatível com dispositivos otimizados para computação do Snowball Edge. Antes de comprar um dispositivo Snowball Edge, há algumas coisas que você deve fazer para se preparar. + Crie e forneça uma imagem do sistema operacional para usar na criação de máquinas virtuais no dispositivo. + Sua rede deve ter um endereço IP estático disponível para o endpoint do ambiente de gerenciamento de K8s e permitir o Protocolo de Resolução de Endereço (ARP). + Seu dispositivo Snowball Edge deve ter portas específicas abertas. Para obter mais informações sobre portas, consulte [Portas e protocolos](https://anywhere.eks.amazonaws.com/docs/reference/ports/) na documentação do Amazon EKS Anywhere. **Topics** + [Crie uma AMI de distribuição Ubuntu EKS para o Snowball Edge](#create-eksd-ami) + [Crie uma AMI Harbor para o Snowball Edge](#existing-private-registry) ## Crie uma AMI de distribuição Ubuntu EKS para o Snowball Edge Para criar a AMI da distribuição Ubuntu EKS, consulte [Criar imagens de nós do Snow](https://anywhere.eks.amazonaws.com/docs/reference/artifacts/#build-snow-node-images). O nome da AMI gerada seguirá o padrão `capa-ami-ubuntu-20.04-version-timestamp`. Por exemplo, .`capa-ami-ubuntu-20.04-v1.24-1672424524` ## Crie uma AMI Harbor para o Snowball Edge Configure uma AMI de registro privado do Harbor para incluir no dispositivo Snowball Edge para que você possa usar o Amazon EKS Anywhere no dispositivo sem uma conexão de rede externa. Se você não usar o Amazon EKS Anywhere enquanto o dispositivo Snowball Edge estiver desconectado da rede externa, ou se tiver um registro privado do Kubernetes em uma AMI para usar no dispositivo, pule esta seção. Para criar a AMI do registro local do Harbor, consulte [Criar uma AMI do Harbor](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/container-registry-ami-builder#build-harbor-ami). # Solicitando um dispositivo Snowball Edge para uso com o Amazon EKS Anywhere on Snow AWS Para fazer com que seu Snowball Edge seja otimizado para computação, consulte [Criação de um trabalho para solicitar um dispositivo Snowball Edge](create-job-common.md) este guia e lembre-se desses itens durante o processo de pedido: + Na etapa 1, escolha o tipo de tarefa **Somente computação e armazenamento locais**. + Na etapa 2, escolha o tipo de dispositivo **Snowball Edge Compute** Optimized. + Na etapa 3, escolha **Amazon EKS Anywhere on AWS Snow** e escolha a versão do Kubernetes de que você precisa. **nota** Para fornecer o software mais recente, podemos configurar o dispositivo com uma versão do ESK Anywhere mais recente do que a que está disponível atualmente. Para ter mais informações, consulte [Versioning](https://anywhere.eks.amazonaws.com/docs/concepts/support-versions/) no *Manual do usuário do Amazon EKS*. Recomendamos que você crie o cluster do Kubernetes com a versão mais recente disponível e aceita no Amazon EKS Anywhere. Para ter mais informações, consulte [Amazon EKS-Anywhere Versioning](https://anywhere.eks.amazonaws.com/docs/concepts/support-versions/). Se a aplicação exigir uma versão específica do Kubernetes, use qualquer versão do Kubernetes oferecida no suporte padrão ou estendido do Amazon EKS. Pense nas datas de lançamento e de suporte das versões do Kubernetes ao planejar o ciclo de vida da implantação. Isso ajudará você a evitar a possível perda de suporte da versão do Kubernetes a ser utilizada. Para ter mais informações, consulte [Calendário de lançamento do Amazon EKS Kubernetes](https://docs.aws.amazon.com/eks/latest/userguide/kubernetes-versions.html#kubernetes-release-calendar). + Escolha AMIs incluir em seu dispositivo, incluindo a AMI EKS Distro (consulte[Crie uma AMI de distribuição Ubuntu EKS para o Snowball Edge](eksa-gettingstarted.md#create-eksd-ami)) e, opcionalmente, a AMI Harbor que você criou ([Crie uma AMI Harbor para o Snowball Edge](eksa-gettingstarted.md#existing-private-registry)consulte). + Se você precisar de vários dispositivos Snowball Edge para obter alta disponibilidade, escolha o número de dispositivos necessários em **Alta disponibilidade**. Depois de receber seu dispositivo ou dispositivos Snowball Edge, configure o Amazon EKS Anywhere de acordo com [Configuração e execução do Amazon EKS Anywhere em dispositivos Snowball Edge](eksa-configuration.md). # Configuração e execução do Amazon EKS Anywhere em dispositivos Snowball Edge Siga esses procedimentos para configurar e iniciar o Amazon EKS Anywhere em seus dispositivos Snowball Edge. Em seguida, para configurar o Amazon EKS Anywhere para operar em dispositivos desconectados, conclua procedimentos adicionais antes de desconectar esses dispositivos da rede externa. Para obter mais informações, consulte [Configuração do Amazon EKS Anywhere on AWS Snow para operação desconectada](configure-disconnected.md). **Topics** + [Configuração inicial do Amazon EKS Anywhere no Snowball Edge](#initial-setup) + [Configuração e execução automática do Amazon EKS Anywhere em dispositivos Snowball Edge](#auto-eksa-configuration) + [Configurando e executando o Amazon EKS Anywhere em dispositivos Snowball Edge manualmente](#manual-eksa-configuration) ## Configuração inicial do Amazon EKS Anywhere no Snowball Edge Execute a configuração inicial em cada dispositivo Snowball Edge conectando o dispositivo à sua rede local, baixando o Snowball Edge Client, obtendo credenciais e desbloqueando o dispositivo. **Execute a configuração inicial** 1. Faça o download e instale o Snowball Edge Client. Para obter mais informações, consulte [Baixar e instalar o Snowball Edge Client](using-client-commands.md#download-the-client). 1. Conecte o dispositivo à rede local. Para obter mais informações, consulte [Conectando um Snowball Edge à sua rede local](getting-started.md#getting-started-connect). 1. Obtenha credenciais para desbloquear seu dispositivo. Para obter mais informações, consulte [Obter credenciais para acessar um Snowball Edge](getting-started.md#get-credentials). 1. Desbloqueie o dispositivo. Para obter mais informações, consulte [Desbloquear o Snowball Edge](unlockdevice.md). Você também pode usar uma ferramenta de script em vez de desbloquear dispositivos manualmente. Consulte [Desbloquear dispositivos](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/setup-tools#Unlock-devices). ## Configuração e execução automática do Amazon EKS Anywhere em dispositivos Snowball Edge Você pode usar exemplos de ferramentas de script para configurar o ambiente e executar uma instância administrativa do Amazon EKS Anywhere ou pode fazer isso manualmente. Para usar as ferramentas de script, consulte [Desbloquear dispositivos e ambiente de configuração para o Amazon EKS Anywhere](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/setup-tools#Unlock-devices-and-setup-envorinment-for-EKS-Anywhere). Depois que o ambiente estiver configurado e a instância administrativa do Amazon EKS Anywhere estiver em execução, se você precisar configurar o Amazon EKS Anywhere para operar no dispositivo Snowball Edge enquanto estiver desconectado de uma rede, consulte [Configuração do Amazon EKS Anywhere on AWS Snow para operação desconectada](configure-disconnected.md). Caso contrário, consulte [Criar clusters e realizar a manutenção deles em dispositivos Snowball Edge](maintain-eks-a-clusters-snow.md). Para configurar manualmente o ambiente e executar uma instância administrativa do Amazon EKS Anywhere, consulte [Configurando e executando o Amazon EKS Anywhere em dispositivos Snowball Edge manualmente](#manual-eksa-configuration). ## Configurando e executando o Amazon EKS Anywhere em dispositivos Snowball Edge manualmente Antes de configurar o Amazon EKS Anywhere em um dispositivo Snowball Edge, configure um perfil para o Snowball Edge Client. Para obter mais informações, consulte [Configurar e usar o Snowball Edge Client](using-client-commands.md). **Topics** + [Crie um usuário local do IAM do Amazon EKS Anywhere](#create-role) + [(Opcional) Crie e importe uma chave Secure Shell em um Snowball Edge](#create-ssh-key) + [Execute uma instância administrativa do Amazon EKS Anywhere em um Snowball Edge e transfira arquivos de credenciais e certificados para ela](#start-config-eksa-admin-instance) ### Crie um usuário local do IAM do Amazon EKS Anywhere Para obter as melhores práticas de segurança, crie um usuário local do IAM para o Amazon EKS Anywhere no dispositivo Snowball Edge. Isso pode ser feito manualmente por meio dos procedimentos a seguir. **nota** Faça isso para cada dispositivo Snowball Edge que você usa. #### Crie um usuário local no Snowball Edge Use o comando `create-user` para criar o usuário IAM do Amazon EKS Anywhere. ``` aws iam create-user --user-name user-name --endpoint http://snowball-ip:6078 --profile profile-name { "User": { "Path": "/", "UserName": "eks-a-user", "UserId": "AIDACKCEVSQ6C2EXAMPLE", "Arn": "arn:aws:iam::123456789012:user/eks-a-user", "CreateDate": "2022-04-06T00:13:35.665000+00:00" } } ``` #### Crie uma política para o usuário local no Snowball Edge Crie um documento de política, use-o para criar uma política do IAM e anexe essa política ao usuário local do Amazon EKS Anywhere. **Para criar um documento de política e anexá-lo ao usuário local do Amazon EKS Anywhere** 1. Crie um documento de política e salve-o no computador. Copie a política abaixo para o documento. ------ #### [ JSON ] **** ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "snowball-device:DescribeDevice", "snowball-device:CreateDirectNetworkInterface", "snowball-device:DeleteDirectNetworkInterface", "snowball-device:DescribeDirectNetworkInterfaces", "snowball-device:DescribeDeviceSoftware" ], "Resource": ["*"] }, { "Effect": "Allow", "Action": [ "ec2:RunInstances", "ec2:DescribeInstances", "ec2:TerminateInstances", "ec2:ImportKeyPair", "ec2:DescribeKeyPairs", "ec2:DescribeInstanceTypes", "ec2:DescribeImages", "ec2:DeleteTags" ], "Resource": ["*"] } ] } ``` ------ 1. Use o comando `create-policy` para criar uma política do IAM com base no documento de política. O valor do parâmetro `--policy-document` deve usar o caminho absoluto para o arquivo de política. Por exemplo, `file:///home/user/policy-name.json`. ``` aws iam create-policy --policy-name policy-name --policy-document file:///home/user/policy-name.json --endpoint http://snowball-ip:6078 --profile profile-name { "Policy": { "PolicyName": "policy-name", "PolicyId": "ANPACEMGEZDGNBVGY3TQOJQGEZAAAABP76TE5MKAAAABCCOTR2IJ43NBTJRZBU", "Arn": "arn:aws:iam::123456789012:policy/policy-name", "Path": "/", "DefaultVersionId": "v1", "AttachmentCount": 0, "IsAttachable": true, "CreateDate": "2022-04-06T04:46:56.907000+00:00", "UpdateDate": "2022-04-06T04:46:56.907000+00:00" } } ``` 1. Use o comando `attach-user-policy` para anexar a política do IAM ao usuário local do Amazon EKS Anywhere. ``` aws iam attach-user-policy --policy-arn policy-arn --user-name user-name --endpoint http://snowball-ip:6078 --profile profile-name ``` #### Crie uma chave de acesso e um arquivo de credencial no Snowball Edge Crie uma chave de acesso para o usuário local do IAM do Amazon EKS Anywhere. Em seguida, crie um arquivo de credencial e inclua nele os valores `AccessKeyId` e `SecretAccessKey` gerados para o usuário local. O arquivo de credencial será usado posteriormente pela instância administrativa do Amazon EKS Anywhere. 1. Use o comando `create-access-key` para criar uma chave de acesso para o usuário local do Amazon EKS Anywhere. ``` aws iam create-access-key --user-name user-name --endpoint http://snowball-ip:6078 --profile profile-name { "AccessKey": { "UserName": "eks-a-user", "AccessKeyId": "AKIAIOSFODNN7EXAMPLE", "Status": "Active", "SecretAccessKey": "RTT/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "CreateDate": "2022-04-06T04:23:46.139000+00:00" } } ``` 1. Crie um arquivo de credencial. Nele, salve os valores `AccessKeyId` e `SecretAccessKey` no formato a seguir. ``` [snowball-ip] aws_access_key_id = ABCDEFGHIJKLMNOPQR2T aws_secret_access_key = AfSD7sYz/TBZtzkReBl6PuuISzJ2WtNkeePw+nNzJ region = snow ``` **nota** Se você estiver trabalhando com vários dispositivos Snowball Edge, a ordem das credenciais no arquivo não importa, mas as credenciais de todos os dispositivos precisam estar em um arquivo. #### Crie um arquivo de certificados para a instância administrativa no Snowball Edge A instância administrativa do Amazon EKS Anywhere precisa dos certificados dos dispositivos Snowball Edge para ser executada neles. Crie um arquivo de certificados contendo o certificado para acessar os dispositivos Snowball Edge para uso posterior pela instância administrativa do Amazon EKS Anywhere. **Para criar um arquivo de certificados** 1. Use o comando `list-certificates` para obter certificados para cada dispositivo Snowball Edge que você planeja usar. ``` PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge list-certificates --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code { "Certificates" : [ { "CertificateArn" : "arn:aws:snowball-device:::certificate/xxx", "SubjectAlternativeNames" : [ "ID:JID-xxx" ] } ] } ``` 1. Use o valor de `CertificateArn` como valor para o parâmetro `--certificate-arn` do comando `get-certificate`. ``` PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge get-certificate --certificate-arn ARN --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code ``` 1. Crie um arquivo de certificado de dispositivo. Coloque a saída de `get-certificate` no arquivo de certificado. A seguir, veja um exemplo de como salvar a saída. **nota** Se você estiver trabalhando com vários dispositivos Snowball Edge, a ordem das credenciais no arquivo não importa, mas as credenciais de todos os dispositivos precisam estar em um arquivo. ``` -----BEGIN CERTIFICATE----- ZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGUgZWtzYSBzbm93IHRlc3QgY2VydGlm aWNhdGVla3NhIHNub3cgdGVzdCBjZXJ0aWZpY2F0ZWVrc2Egc25vdyB0ZXN0IGNl cnRpZmljYXRlZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGVla3NhIHNub3cgdGVz dCBjZXJ0aWZpY2F0ZQMIIDXDCCAkSgAwIBAgIJAISM0nTVmbj+MA0GCSqGSIb3DQ ... -----END CERTIFICATE----- ``` 1. Repita o procedimento [Crie um usuário local do IAM do Amazon EKS Anywhere](#create-role) para criar um usuário local do IAM para o Amazon EKS Anywhere em todos os dispositivos Snowball Edge. ### (Opcional) Crie e importe uma chave Secure Shell em um Snowball Edge Use esse procedimento opcional para criar uma chave Secure Shell (SSH) para acessar todas as instâncias de nós do Amazon EKS Anywhere e importar a chave pública para todos os dispositivos Snowball Edge. Mantenha e proteja esse arquivo de chave. Se você pular esse procedimento, o Amazon EKS Anywhere criará e importará uma chave SSH automaticamente quando for necessário. Essa chave será armazenada na instância administrativa em `${PWD}/${CLUSTER_NAME}/eks-a-id_rsa`. **Crie uma chave SSH e importe-a para a instância do Amazon EKS Anywhere** 1. Use o comando `ssh-keygen` para gerar uma chave SSH. ``` ssh-keygen -t rsa -C "key-name" -f path-to-key-file ``` 1. Use o comando `import-key-pair` para importar a chave do seu computador para o dispositivo Snowball Edge. **nota** O valor do parâmetro `key-name` deve ser o mesmo quando você importa a chave para todos os dispositivos. ``` aws ec2 import-key-pair --key-name key-name --public-key-material fileb:///path/to/key-file --endpoint http://snowball-ip:8008 --profile profile-name { "KeyFingerprint": "5b:0c:fd:e1:a0:69:05:4c:aa:43:f3:3b:3e:04:7f:51", "KeyName": "default", "KeyPairId": "s.key-85edb5d820c92a6f8" } ``` ### Execute uma instância administrativa do Amazon EKS Anywhere em um Snowball Edge e transfira arquivos de credenciais e certificados para ela #### Execute uma instância administrativa do Amazon EKS Anywhere em um Snowball Edge Siga este procedimento para executar manualmente uma instância administrativa do Amazon EKS Anywhere, configurar uma interface de rede virtual (VNI) para a instância administrativa, verificar o status da instância, criar uma chave SSH e conectar-se à instância administrativa com ela. Você pode usar uma ferramenta de script de amostra para automatizar a criação de uma instância administrativa do Amazon EKS Anywhere e a transferência de arquivos de credenciais e certificados para essa instância. Consulte [Criar instância administrativa do Amazon EKS Anywhere](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/setup-tools#Create-EKS-Anywhere-admin-instance). Depois que a ferramenta de script for concluída, você poderá entrar por ssh na instância e criar clusters consultando a [Criar clusters e realizar a manutenção deles em dispositivos Snowball Edge](maintain-eks-a-clusters-snow.md). Se você quiser configurar a instância do Amazon EKS Anywhere manualmente, use as seguintes etapas. **nota** Se você estiver usando mais de um dispositivo Snowball Edge para provisionar o cluster, poderá iniciar uma instância administrativa do Amazon EKS Anywhere em qualquer um dos dispositivos do Snowball Edge. **Para executar uma instância administrativa do Amazon EKS Anywhere** 1. Use o comando `create-key-pair` para criar uma chave SSH para a instância administrativa do Amazon EKS Anywhere. O comando salva a chave em `$PWD/key-file-name`. ``` aws ec2 create-key-pair --key-name key-name --query 'KeyMaterial' --output text --endpoint http://snowball ip:8008 > key-file-name --profile profile-name ``` 1. Use o comando `describe-images` para encontrar o nome da imagem que começa com `eks-anywhere-admin` na saída. ``` aws ec2 describe-images --endpoint http://snowball-ip:8008 --profile profile-name ``` 1. Use o comando `run-instance` para iniciar uma instância de administração eks-a com a imagem de administrador do Amazon EKS Anywhere. ``` aws ec2 run-instances --image-id eks-a-admin-image-id --key-name key-name --instance-type sbe-c.xlarge --endpoint http://snowball-ip:8008 --profile profile-name ``` 1. Use o comando `describe-instances` para verificar o estado da instância do Amazon EKS Anywhere. Espere até que o comando indique que o estado da instância é `running` antes de continuar. ``` aws ec2 describe-instances --instance-id instance-id --endpoint http://snowball-ip:8008 --profile profile-name ``` 1. Na saída do comando `describe-device`, observe o valor de `PhysicalNetworkInterfaceId` para a interface de rede física conectada à sua rede. Isso será usado para criar uma VNI. ``` PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge describe-device --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code ``` 1. Crie uma VNI para a instância administrativa do Amazon EKS Anywhere. Use o valor de `PhysicalNetworkInterfaceId` como o valor do parâmetro `physical-network-interface-id`. ``` PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge create-virtual-network-interface --ip-address-assignment dhcp --physical-network-interface-id PNI --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code ``` 1. Use o valor de `IpAddress` como o valor do parâmetro `public-ip` do comando `associate-address` para associar o endereço público à instância administrativa do Amazon EKS Anywhere. ``` aws ec2 associate-address --instance-id instance-id --public-ip VNI-IP --endpoint http://snowball-ip:8008 --profile profile-name ``` 1. Conecte-se à instância administrativa do Amazon EKS Anywhere por SSH. ``` ssh -i path-to-key ec2-user@VNI-IP ``` #### Transfira arquivos de certificado e credencial para a instância administrativa no Snowball Edge Depois que a instância administrativa do Amazon EKS Anywhere estiver em execução, transfira as credenciais e os certificados dos seus dispositivos Snowball Edge para a instância administrativa. Execute o seguinte comando no mesmo diretório em que você salvou os arquivos de credenciais e certificados em [Crie uma chave de acesso e um arquivo de credencial no Snowball Edge](#create-eksa-iam-user-access-key) e [Crie um arquivo de certificados para a instância administrativa no Snowball Edge](#create-credentials-for-admin-instance). ``` scp -i path-to-key path-to-credentials-file path-to-certificates-file ec2-user@eks-admin-instance-ip:~ ``` Verifique o conteúdo dos arquivos na instância administrativa do Amazon EKS Anywhere. Veja a seguir exemplos dos arquivos de credenciais e certificados. ``` [192.168.1.1] aws_access_key_id = EMGEZDGNBVGY3TQOJQGEZB5ULEAAIWHWUJDXEXAMPLE aws_secret_access_key = AUHpqjO0GZQHEYXDbN0neLNlfR0gEXAMPLE region = snow [192.168.1.2] aws_access_key_id = EMGEZDGNBVGY3TQOJQGEZG5O7F3FJUCMYRMI4KPIEXAMPLE aws_secret_access_key = kY4Cl8+RJAwq/bu28Y8fUJepwqhDEXAMPLE region = snow ``` ``` -----BEGIN CERTIFICATE----- ZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGUgZWtzYSBzbm93IHRlc3QgY2VydGlm aWNhdGVla3NhIHNub3cgdGVzdCBjZXJ0aWZpY2F0ZWVrc2Egc25vdyB0ZXN0IGNl cnRpZmljYXRlZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGVla3NhIHNub3cgdGVz dCBjZXJ0aWZpY2F0ZQMIIDXDCCAkSgAwIBAgIJAISM0nTVmbj+MA0GCSqGSIb3DQ ... -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- KJ0FPl2PAYPEjxr81/PoCXfZeARBzN9WLUH5yz1ta+sYUJouzhzWuLJYA1xqcCPY mhVlkRsN4hVdlBNRnCCpRF766yjdJeibKVzXQxoXoZBjrOkuGwqRy3d3ndjK77h4 OR5Fv9mjGf7CjcaSjk/4iwmZvRSaQacb0YG5GVeb4mfUAuVtuFoMeYfnAgMBAAGj azBpMAwGA1UdEwQFMAMBAf8wHQYDVR0OBBYEFL/bRcnBRuSM5+FcYFa8HfIBomdF ... -----END CERTIFICATE----- ``` # Configuração do Amazon EKS Anywhere on AWS Snow para operação desconectada Conclua essa configuração adicional do Amazon EKS Anywhere no dispositivo Snowball Edge enquanto ele estiver conectado a uma rede para preparar o Amazon EKS Anywhere para ser executado em um ambiente sem uma conexão de rede externa. Para configurar o Amazon EKS Anywhere para uso desconectado com seu próprio registro local e privado do Kubernetes, consulte [Configuração do espelho do registro](https://anywhere.eks.amazonaws.com/docs/reference/clusterspec/optional/registrymirror/) na documentação do EKS Anywhere. Se você criou uma AMI de registro privado do Harbor, siga os procedimentos nesta seção. **Topics** + [Configurar o registro do Harbor em um dispositivo Snowball Edge](#configure-harbor-snow) + [Use o registro Harbor na instância administrativa do Amazon EKS Anywhere em um Snowball Edge](#use-local-registry-eksa-instance) ## Configurar o registro do Harbor em um dispositivo Snowball Edge Consulte [Configurar o Harbor em um dispositivo Snowball Edge](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/container-registry-ami-builder#configure-harbor-on-a-snowball-edge-device). ## Use o registro Harbor na instância administrativa do Amazon EKS Anywhere em um Snowball Edge Consulte [Importar imagens de contêineres do Amazon EKS Anywhere para o registro local do Harbor em um dispositivo Snowball Edge](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/container-registry-ami-builder#import-eks-anywhere-container-images-to-the-local-harbor-registry-on-a-snowball-device). # Criar clusters e realizar a manutenção deles em dispositivos Snowball Edge ## Melhores práticas para criar clusters em um Snowball Edge Para criar um cluster do Amazon EKS Anywhere, consulte [Create Snow clusters](https://anywhere.eks.amazonaws.com/docs/getting-started/production-environment/snow-getstarted/). Lembre-se das seguintes práticas recomendadas ao criar clusters do Amazon EKS Anywhere em dispositivos Snowball Edge: + Antes de criar um cluster em um intervalo de endereços IP estáticos, não há outros clusters no dispositivo Snowball Edge usando o mesmo intervalo de endereços IP. + Antes de criar um cluster com endereçamento DHCP no dispositivo Snowball Edge, garanta que todos os intervalos de endereços IP estáticos em uso para clusters não estejam na sub-rede do grupo DHCP. + Ao criar mais de um cluster, espere até que um cluster seja provisionado e executado com êxito antes de criar outro. ## Atualizando clusters em um Snowball Edge Para atualizar uma AMI de administrador do Amazon EKS Anywhere ou uma AMI de distribuição EKS, entre em contato com AWS Support. Suporte fornecerá uma atualização do Snowball Edge contendo a AMI atualizada. Em seguida, baixe e instale a atualização do Snowball Edge. Consulte [Baixar atualizações em dispositivos Snowball Edge](download-updates.md) e [Instalar atualizações em dispositivos Snowball Edge](install-updates.md). Depois de atualizar sua AMI do Amazon EKS Anywhere, você precisa iniciar uma nova instância administrativa do Amazon EKS Anywhere. Consulte [Execute uma instância administrativa do Amazon EKS Anywhere em um Snowball Edge](eksa-configuration.md#start-admin-instance). Em seguida, copie os arquivos-chave, a pasta do cluster, as credenciais e os certificados da instância administrativa anterior para a instância atualizada. Eles estão em uma pasta com o nome do cluster. ## Limpando os recursos do cluster em um Snowball Edge Se você criar vários clusters em seus dispositivos Snowball Edge e não os excluir corretamente ou se houver um problema no cluster e o cluster criar nós substitutos após a retomada, haverá vazamento de recursos. Está disponível uma ferramenta de script de exemplo para modificar e usar para limpar a instância administrativa do Amazon EKS Anywhere e os dispositivos Snowball Edge. Consulte as [ferramentas de limpeza do Amazon EKS Anywhere on AWS Snow](https://github.com/aws-samples/aws-snow-tools-for-eks-anywhere/tree/main/cleanup-tools#eks-anywhere-on-snow-cleanup-tools).