Instalar o Docker, a AWS CLI e o plug-in Lightsail Control para contêineres - Amazon Lightsail
Instalar o DockerInstalar o AWS CLIInstalar o plugin de Controle Lightsail

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á.

Instalar o Docker, a AWS CLI e o plug-in Lightsail Control para contêineres

É possível usar o console do Amazon Lightsail para criar seu serviço de contêiner do Lightsail e criar implantações usando imagens de contêiner de um registro público on-line, como o Amazon ECR Public Gallery. Para criar suas próprias imagens de contêiner e enviá-las para seu serviço de contêiner, é necessário instalar o seguinte software adicional no mesmo computador no qual planeja criar suas imagens de contêiner:

  • Docker: execute, teste e crie suas próprias imagens de contêiner que podem ser usadas com seu serviço de contêiner do Lightsail.

  • AWS Command Line Interface (AWS CLI): especifique os parâmetros das imagens de contêiner criadas e as envie para o serviço de contêiner do Lightsail. A versão 2.1.1 e versões posteriores funcionarão com o plugin de Controle do Lightsail.

  • Plug-in de controle do Lightsail (lightsailctl): habilita a AWS CLI para acessar as imagens de contêiner que estão na máquina local.

As seções a seguir deste guia descrevem aonde ir para baixar esses pacotes de software e como instalá-los. Para obter mais informações sobre serviços de contêiner, consulte Serviços de contêiner.

Índice

Instalar o Docker

Docker é uma tecnologia que permite criar, executar, testar e implantar aplicações distribuídas que são baseadas em contêineres do Linux. Você deve instalar e usar o software Docker se quiser criar suas próprias imagens de contêiner que você pode usar com o serviço de contêineres Lightsail. Para obter mais informações, consulte Criar imagens de contêiner para serviços de contêiner do Lightsail.

O Docker está disponível em muitos sistemas operacionais diferentes, incluindo a maioria das distribuições modernas do Linux, como o Ubuntu e até no MacOS e no Windows. Para obter mais informações sobre como instalar o Docker no seu sistema operacional, consulte o Guia de instalação do Docker.

nota

Sempre instale a versão mais recente do Docker. Versões mais antigas do Docker não têm garantia de funcionamento com a AWS CLI e com o plug-in de Controle do Lightsail (lightsailctl) descrito mais adiante neste guia.

Instalar o AWS CLI

O AWS CLI é uma ferramenta de código aberto que permite interagir com os serviços da AWS, como o Lightsail, usando comandos no shell da linha de comando. Instale e use a AWS CLI para enviar suas imagens de contêiner, criadas em sua máquina local, para o serviço de contêiner do Lightsail.

A AWS CLI está disponível nas seguintes versões:

  • Versão 2.x: a versão atual disponível para o público da AWS CLI. Esta é a versão principal mais recente da AWS CLI e é compatível com todos os recursos mais recentes, incluindo a capacidade de enviar imagens de contêiner aos seus serviços de contêiner do Lightsail. A versão 2.1.1 e versões posteriores funcionarão com o plugin de Controle do Lightsail.

  • Versão 1.x: a versão anterior da AWS CLI que está disponível para compatibilidade com versões anteriores. Esta versão não é compatível com a capacidade de enviar suas imagens de contêiner para os seus serviços de contêiner Lightsail. Portanto, instale a versão 2 da AWS CLI em vez disso.

A versão 2 da AWS CLI está disponível para sistemas operacionais Linux, macOS e Windows. Para obter instruções sobre como instalar a AWS CLI nesses sistemas operacionais, consulte Installing the AWS CLI version 2 no Guia do usuário da AWS CLI.

Instalar o plugin de Controle Lightsail

O plug-in de Controle do Lightsail (lightsailctl) é uma aplicação leve que permite que a AWS CLI acesse as imagens de contêiner que você criou na sua máquina local. Ele permite enviar imagens de contêiner para o seu serviço de contêiner Lightsail, para que você possa implantá-los em seu serviço.

Requisitos do sistema

  • Um sistema operacional Windows, macOS ou Linux com versões de 64 bits.

  • A versão 2 da AWS CLI deve ser instalada na sua máquina local para usar o plug-in lightsailctl. Para obter mais informações, consulte a seção Instalar a AWS CLI deste guia.

Usar a versão mais recente do plug-in lightsailctl

O plug-in lightsailctl é atualizado ocasionalmente com funcionalidade aprimorada. Sempre que você usa o plug-in lightsailctl, ele executa uma verificação para confirmar que você está usando a versão mais recente. Se ele descobrir que uma nova versão está disponível, solicitará atualização para a versão mais recente para aproveitar os recursos mais recentes. Quando uma versão atualizada for lançada, você deverá repetir o processo de instalação para instalar a versão mais recente do plug-in lightsailctl.

A tabela a seguir lista todas as versões do plug-in lightsailctl, bem como os recursos e aprimoramentos incluídos em cada versão.

  • v1.0.0 (lançada em 12 de novembro de 2020): versão inicial adiciona funcionalidade para a versão 2 da AWS CLI para enviar imagens de contêiner a um serviço de contêiner do Lightsail.

Instalar o plug-in lightsailctl no Windows

Conclua o procedimento a seguir para instalar um plug-in lightsailctl no Windows.

  1. Baixe o executável no seguinte URL e salve-o no diretório do C:\Temp\lightsailctl\.

    https://s3.us-west-2.amazonaws.com/lightsailctl/latest/windows-amd64/lightsailctl.exe

  2. Escolha o botão Iniciar do Windows e, em seguida, busque por cmd.

  3. Nos resultados de pesquisa, clique com o botão direito do mouse em Prompt de Comando e escolha Executar como administrador.

    Executar o Prompt Run Command como administrador
    nota

    Talvez você veja um prompt perguntando se você deseja permitir que o Prompt de Comando faça alterações no seu dispositivo. É necessário escolher Sim para continuar com a instalação.

  4. Insira o comando a seguir para definir uma variável de ambiente de caminho que aponte para o diretório do C:\Temp\lightsailctl\ onde você salvou o plug-in lightsailctl.

    setx PATH "%PATH%;C:\Temp\lightsailctl" /M

    Será apresentado um resultado semelhante ao seguinte exemplo:

    Resposta da linha de comando ao comando setx

O comando setx truncará acima de 1024 caracteres. Use o procedimento a seguir para definir manualmente a variável de ambiente do caminho, caso você já tenha múltiplas variáveis definidas no PATH.

  1. No menu Start (Iniciar), abra Control Panel (Painel de controle).

  2. Escolha System and Security (Sistema e Segurança) e System (Sistema).

  3. Escolha Configurações de sistema avançadas.

  4. Na guia Advanced (Avançado) da caixa de diálogo System Properties (Propriedades do sistema), escolha Environment Variables (Variáveis de ambiente).

  5. Na caixa System Variables (Variáveis do sistema) da caixa de diálogo Environment Variables (Variáveis de ambiente), selecione Path (Caminho).

  6. Escolha o botão Edit (Editar) localizado abaixo da caixa System Variables (Variáveis do sistema).

    Variáveis do sistema Windows

  7. Escolha New (Novo) e insira o seguinte caminho: C:\Temp\lightsailctl\

    Variáveis de ambiente do Windows

  8. Escolha OK em três caixas de diálogo sucessivas e feche a caixa de diálogo System (Sistema).

Agora você pode usar a AWS Command Line Interface (AWS CLI) para enviar imagens de contêiner ao seu serviço de contêiner do Lightsail. Para obter mais informações, consulte Push and manage container images.

Instalar o plug-in lightsailctl no macOS

Conclua um dos procedimentos a seguir para baixar e instalar um plug-in lightsailctl no macOS.

Download e instalação Homebrew

  1. Abra uma janela do terminal.

  2. Insira o comando a seguir para baixar e instalar o plug-in lightsailctl.

    brew install aws/tap/lightsailctl
    nota

    Para obter mais informações sobre Homebrew, consulte o site Homebrew.

Download e instalação manuais

  1. Abra uma janela do terminal.

  2. Insira o seguinte comando para baixar o plug-in lightsailctl e o copie para a pasta bin.

    curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/darwin-amd64/lightsailctl" -o "/usr/local/bin/lightsailctl"

  3. Insira o comando a seguir para tornar o plugin executável.

    chmod +x /usr/local/bin/lightsailctl

  4. Insira o comando a seguir para limpar os atributos estendidos do plugin.

    xattr -c /usr/local/bin/lightsailctl

Agora você pode usar a AWS CLI para enviar imagens de contêiner ao serviço de contêiner do Lightsail. Para obter mais informações, consulte Push and manage container images.

Instalar o plug-in lightsailctl no Linux

Conclua o procedimento a seguir para instalar o plugin de serviços de contêiner Lightsail no Linux.

  1. Abra uma janela do terminal.

  2. Insire o comando a seguir para baixar o plug-in lightsailctl.

    • Para a versão da arquitetura de 64 bits AMD do plugin:

      curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/linux-amd64/lightsailctl" -o "/usr/local/bin/lightsailctl"

    • Para a versão da arquitetura de 64 bits ARM do plugin:

      curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/linux-arm64/lightsailctl" -o "/usr/local/bin/lightsailctl"

  3. Insira o comando a seguir para tornar o plugin executável.

    sudo chmod +x /usr/local/bin/lightsailctl

    Agora você pode usar a AWS CLI para enviar imagens de contêiner ao serviço de contêiner do Lightsail. Para obter mais informações, consulte Push and manage container images.