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á.
Este tópico descreve como configurar, criar e executar suas aplicações Go no Elastic Beanstalk.
O AWS Elastic Beanstalk suporta uma série de ramificações de plataforma para diferentes versões da linguagem de programação Go. Consulte Go no documento Plataformas do AWS Elastic Beanstalk para uma lista completa.
Quanto aos aplicativos simples em Go, há duas formas de implantá-los:
-
Forneça um pacote de origem com um arquivo de origem na raiz chamado
application.go
, que contém o pacote principal do seu aplicativo. O Elastic Beanstalk cria o binário usando o seguinte comando:go build -o bin/application application.go
Depois que a aplicação é criada, o Elastic Beanstalk a inicia na porta 5000.
-
Forneça um pacote de origem com um arquivo binário chamado
application
. O arquivo binário pode ficar localizado na raiz do pacote de origem ou no diretóriobin/
do pacote de origem. Se você colocar o arquivo binárioapplication
nos dois locais, o Elastic Beanstalk usará o arquivo do diretóriobin/
.O Elastic Beanstalk inicia essa aplicação na porta 5000.
Em ambos os casos, com nossas ramificações da plataforma Go compatíveis, você também pode fornecer requisitos de módulo em um arquivo go.mod
. Para obter mais informações, consulte Migrar para módulos Go
Quanto aos aplicativos mais complexos em Go, há duas formas de implantá-los:
-
Forneça um pacote de origem que inclua os arquivos de origem do aplicativo, juntamente com um Buildfile e um Procfile. O Buildfile inclui um comando para criar o aplicativo e o Procfile inclui instruções para executar o aplicativo.
-
Forneça um pacote de origem que inclua os arquivos binários do aplicativo, juntamente com um Procfile. O Procfile inclui instruções para executar o aplicativo.
A plataforma Go inclui um servidor de proxy para atender a ativos estáticos e encaminhar o tráfego para sua aplicação. Você pode estender ou substituir a configuração de proxy padrão para cenários avançados.
Para obter detalhes sobre as várias maneiras de estender uma plataforma do Elastic Beanstalk baseada em Linux, consulte Estender as plataformas Linux do Elastic Beanstalk.
Configurar o ambiente Go
As configurações da plataforma Go permitem que você ajuste o comportamento das instâncias do Amazon EC2. É possível editar a configuração da instância do Amazon EC2 do ambiente do Elastic Beanstalk usando o console do Elastic Beanstalk.
Você pode usar o console do Elastic Beanstalk para habilitar a alternância de logs para o Amazon S3 e configurar variáveis que sua aplicação pode ler no ambiente.
Como configurar o ambiente Go no console do Elastic Beanstalk
Abra o console do Elastic Beanstalk
e, na lista Regions (Regiões), selecione a sua Região da AWS. -
No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.
nota
Se você tiver muitos ambientes, use a barra de pesquisa para filtrar a lista de ambientes.
No painel de navegação, escolha Configuration (Configuração).
-
Na categoria de configuração Updates, monitoring, and logging (Atualizações, monitoramento e logs), escolha Edit (Editar).
Opções de log
A seção Log Options tem duas configurações:
-
Instance profile (Perfil da instância): especifica o perfil da instância que tem permissão para acessar o bucket do Amazon S3 associado à sua aplicação.
-
Enable log file rotation to Amazon S3 (Habilitar a rotação de arquivos de log para o Amazon S3): especifica se os arquivos de log das instâncias do Amazon EC2 da aplicação serão copiados para o bucket do Amazon S3 associado a ela.
Arquivos estáticos
Para melhorar a performance, você pode usar a seção Static files (Arquivos estáticos) para configurar o servidor proxy para servir arquivos estáticos (por exemplo, HTML ou imagens) de um conjunto de diretórios dentro da aplicação Web. Defina, para cada diretório, o caminho virtual para mapeamento de diretórios. Quando o servidor de proxy recebe uma solicitação para um arquivo no caminho especificado, ele atende o arquivo diretamente em vez de rotear solicitação para seu aplicativo.
Para ver detalhes sobre como configurar arquivos estáticos usando arquivos de configuração ou o console do Elastic Beanstalk, consulte Fornecer arquivos estáticos.
Propriedades de ambiente
A seção Environment Properties permite que você especifique definições de configuração do ambiente nas instâncias do Amazon EC2 que estão executando seu aplicativo. As propriedades de ambiente são passadas para o aplicativo como pares de chave-valor.
No ambiente Go executado no Elastic Beanstalk, as variáveis de ambiente podem ser acessadas usando a função os.Getenv
. Por exemplo, você pode ler uma propriedade denominada API_ENDPOINT
em uma variável com o seguinte código:
endpoint := os.Getenv("API_ENDPOINT")
Consulte Propriedades de ambientes e outras configurações de software para obter mais informações.
Namespace de configuração do Go
Você pode usar um arquivo de configuração para definir opções de configuração e executar outras tarefas de configuração de instância durante implantações. Opções de configuração podem ser específicas da plataforma ou aplicáveis a todas as plataformas no serviço Elastic Beanstalk como um todo. As opções de configuração são organizadas em namespaces.
A plataforma Go não define nenhum namespace específico da plataforma. É possível configurar o proxy para servir arquivos estáticos usando o namespace aws:elasticbeanstalk:environment:proxy:staticfiles
. Para obter detalhes e um exemplo, consulte Fornecer arquivos estáticos.
O Elastic Beanstalk oferece muitas opções de configuração para personalizar o ambiente. Além de arquivos de configuração, você também pode definir opções de configuração usando o console, configurações salvas, a EB CLI ou a AWS CLI. Consulte Opções de configuração para obter mais informações.
Se o ambiente Go do Elastic Beanstalk usar uma versão da plataforma AMI do Amazon Linux (anterior ao Amazon Linux 2), leia as informações adicionais nesta seção.
Observações
-
As informações neste tópico somente são aplicáveis a ramificações de plataforma com base na Amazon Linux AMI (AL1). As ramificações de plataforma AL2023/AL2 são incompatíveis com as versões anteriores da plataforma Amazon Linux AMI (AL1) e exigem definições de configuração diferentes.
-
Em 18 de julho de 2022, o Elastic Beanstalk definiu o status de todas as ramificações de plataforma baseadas no Amazon Linux AMI (AL1) como descontinuadas. Para obter mais informações sobre como migrar para uma ramificação da plataforma Amazon Linux 2023 atual e totalmente compatível, consulte Migrar a aplicação Linux do Elastic Beanstalk para o Amazon Linux 2023 ou Amazon Linux 2.
Você pode usar um arquivo de configuração para definir opções de configuração e executar outras tarefas de configuração de instância durante implantações. Opções de configuração podem ser específicas da plataforma ou aplicáveis a todas as plataformas no serviço Elastic Beanstalk como um todo. As opções de configuração são organizadas em namespaces.
nota
As informações neste tópico somente são aplicáveis a ramificações de plataforma com base na Amazon Linux AMI (AL1). As ramificações de plataforma AL2023/AL2 são incompatíveis com as versões anteriores da plataforma Amazon Linux AMI (AL1) e exigem definições de configuração diferentes.
A plataforma Go da AMI do Amazon Linux é compatível com um namespace de configuração específico da plataforma, além dos namespaces compatíveis com todas as plataformas. O namespace aws:elasticbeanstalk:container:golang:staticfiles
permite que você defina opções que mapeiam os caminhos em seu aplicativo Web para as pastas em seu pacote de origem do aplicativo que incluem o conteúdo estático.
Por exemplo, este arquivo de configuração informa ao servidor de proxy que deve servir arquivos da pasta staticimages
no caminho /images
:
exemplo .ebextensions/go-settings.config
option_settings:
aws:elasticbeanstalk:container:golang:staticfiles:
/html: statichtml
/images: staticimages
O Elastic Beanstalk oferece muitas opções de configuração para personalizar o ambiente. Além de arquivos de configuração, você também pode definir opções de configuração usando o console, configurações salvas, a EB CLI ou a AWS CLI. Consulte Opções de configuração para obter mais informações.