Usando AWS App Runner com o AWS Toolkit - AWS Cloud9
Pré-requisitosDefinição de preço

AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. Saiba mais

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 AWS App Runner com o AWS Toolkit

O AWS App Runner fornece um modo rápido e econômico de fazer implantações a partir de código-fonte ou de uma imagem de contêiner diretamente em uma aplicação Web escalável e segura, na Nuvem Nuvem AWS. Ao usá-lo, você não precisa aprender novas tecnologias, decidir qual serviço de computação usar ou saber como provisionar e configurar AWS recursos.

Você pode usar AWS App Runner para criar e gerenciar serviços com base em uma imagem de origem ou código-fonte. Se você usar uma imagem-fonte, poderá escolher uma imagem de contêiner pública ou privada, armazenada em um repositório de imagens. O App Runner é compatível com os seguintes provedores de repositórios de imagens:

  • Amazon Elastic Container Registry (AmazonECR): armazena imagens privadas em seu Conta da AWS.

  • Amazon Elastic Container Registry Public (Amazon ECR Public): armazena imagens legíveis publicamente.

Se você escolher a opção de código-fonte, poderá implantar a partir de um repositório de códigos-fonte mantido por um provedor de repositórios compatível. Atualmente, o App Runner oferece suporte GitHubcomo provedor de repositório de código-fonte.

Pré-requisitos

Para interagir com o App Runner usando o AWS kit de ferramentas, é necessário o seguinte:

  • Um Conta da AWS

  • Uma versão do AWS Toolkit que apresenta AWS App Runner

Além desses requisitos básicos, certifique-se de que todos os IAM usuários relevantes tenham permissões para interagir com o serviço App Runner. Certifique-se também de obter informações específicas sobre sua fonte de serviço, como a imagem do contêiner URI e a conexão com o GitHub repositório. Você precisa dessas informações para criar o serviço do App Runner.

Para conceder rapidamente as permissões necessárias para o App Runner, anexe uma política AWS gerenciada existente à entidade relevante AWS Identity and Access Management (IAM). Especificamente, você pode anexar uma política a um usuário ou grupo. O App Runner fornece duas políticas gerenciadas que você pode anexar aos seus IAM usuários:

  • AWSAppRunnerFullAccess: permite que os usuários realizem todas as ações do App Runner.

  • AWSAppRunnerReadOnlyAccess: permite que os usuários listem e visualizem detalhes sobre os recursos do App Runner.

Se você escolher um repositório privado do Amazon Elastic Container Registry (AmazonECR) como fonte de serviço, você também deverá criar a seguinte função de acesso para seu serviço App Runner:

  • AWSAppRunnerServicePolicyForECRAccess: permite que o App Runner acesse imagens do Amazon Elastic Container Registry (AmazonECR) em sua conta.

Você pode criar essa função automaticamente ao configurar a instância do serviço com o painel de comandos do Kit de ferramentas da AWS .

nota

A função AWSServiceRoleForAppRunnervinculada ao serviço permite AWS App Runner concluir as seguintes tarefas:

  • Envie registros para grupos de CloudWatch registros do Amazon Logs.

  • Crie regras do Amazon CloudWatch Events para assinar o push de imagem do Amazon Elastic Container Registry (AmazonECR).

Você não precisa criar manualmente o perfil vinculado ao serviço. Quando você cria um AWS App Runner no AWS Management Console ou usando API operações chamadas pelo AWS Toolkit, AWS App Runner cria essa função vinculada ao serviço para você.

Para mais informações, consulte Identity and access management for App Runner (Gerenciamento de identidade e acesso para o App Runner) no Guia do desenvolvedor do AWS App Runner .

Você pode usar o AWS App Runner para implantar serviços a partir de uma imagem ou código-fonte.

Source image

Se você estiver implantando a partir de uma imagem de origem, obtenha um link para o repositório dessa imagem em um registro de AWS imagem público ou privado.

nota

Você também pode obter o URI para um ECR repositório privado da Amazon diretamente do AWS Explorer no AWS Toolkit:

  • Abra o AWS Explorer e expanda o ECRnó para ver a lista de repositórios para isso Região da AWS.

  • Abra o menu de contexto (clique com o botão direito do mouse) de um repositório e escolha Copiar repositório URI para copiar o link para sua área de transferência.

Você especifica o URI para o repositório de imagens ao configurar sua instância de serviço com o painel de comando do AWS Toolkit.

Para mais informações, consulte App Runner service based on a source image (Serviço do App Runner baseado em uma imagem-fonte) no Guia do desenvolvedor do AWS App Runner .

Source code

Para que seu código-fonte seja implantado em um AWS App Runner serviço, esse código deve ser armazenado em um repositório Git. Esse repositório Git deve ser mantido por um provedor de repositório compatível. O App Runner oferece suporte a um provedor de repositório de código-fonte:. GitHub

Para obter informações sobre como configurar um GitHub repositório, consulte a documentação de introdução em GitHub.

Para implantar seu código-fonte em um serviço do App Runner a partir de um GitHub repositório, o App Runner estabelece uma conexão com. GitHub Se seu repositório for privado (ou seja, não estiver acessível publicamente no GitHub), você deverá fornecer ao App Runner os detalhes da conexão.

Importante

Para criar GitHub conexões, você deve usar o console do App Runner (https://console.aws.amazon.com/apprunner) para criar uma conexão vinculada a. GitHub AWS Você pode selecionar as conexões que estão disponíveis na página de GitHubconexões ao configurar sua instância de serviço com o painel de comando do AWS Toolkit.

Para mais informações, consulte Managing App Runner connections (Gerenciar conexões do App Runnner) no Guia do desenvolvedor do AWS App Runner .

A instância do serviço App Runner fornece um tempo de execução gerenciado que permite que seu código seja criado e executado. AWS App Runner atualmente suporta os seguintes tempos de execução:

  • Runtime gerenciado pelo Python

  • Tempo de execução gerenciado pelo Node.js

Como parte da configuração do serviço, você fornece informações sobre como o serviço do App Runner compila e inicia o serviço. Você pode inserir essas informações usando a Paleta de Comandos ou especificar um arquivo YAML de configuração do App Runner formatado. Os valores desse arquivo instruem o App Runner sobre como compilar e iniciar o serviço e fornecem o contexto do runtime. Isso inclui configurações de rede e variáveis de ambiente relevantes. O arquivo de configuração é denominado apprunner.yaml. Ele é adicionado automaticamente ao diretório raiz do repositório da aplicação.

Definição de preço

A cobrança será efetuada pelos recursos de computação e de memória que sua aplicação usar. Além disso, se você automatizar as implantações, pagará também uma taxa mensal definida para cada aplicação, que cobrirá todas as implantações automatizadas para aquele mês. Se você optar por implantar a partir do código-fonte, você também pagará uma taxa de compilação pela quantidade de tempo que o App Runner leva para criar um contêiner a partir do código-fonte.

Para obter mais informações, consulte Preços do AWS App Runner.

Tópicos