Usando AWS App Runner com AWS Toolkit for Visual Studio Code - AWS Kit de ferramentas para VS Code
Pré-requisitosDefinição de preço

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 AWS Toolkit for Visual Studio Code

AWS App Runnerfornece uma maneira rápida, simples e econômica de implantar a partir do código-fonte ou de uma imagem de contêiner diretamente em um aplicativo web escalável e seguro na AWS nuvem. 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 (Amazon ECR): armazena imagens privadas em AWS sua conta.

  • Amazon Elastic Container Registry Public (Amazon ECR Public): armazena imagens que podem ser lidas pelo público.

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 Toolkit for Visual Studio Code necessário o seguinte:

  • Uma AWS conta

  • Uma versão AWS Toolkit for Visual Studio Code desses recursos AWS App Runner

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

A maneira mais fácil de conceder as permissões necessárias para o App Runner é anexar uma política AWS gerenciada existente à entidade relevante AWS Identity and Access Management (IAM), especificamente um usuário ou grupo. O App Runner fornece duas políticas gerenciadas que podem ser anexadas aos usuários do IAM:

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

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

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

Você pode criar essa função automaticamente ao configurar sua instância de serviço com a paleta de comandos do VS Code.

nota

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

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

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

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 operações de API chamadas por AWS Toolkit for Visual Studio Code, 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, poderá obter 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 de um repositório privado do Amazon ECR diretamente do AWS Explorer no kit de ferramentas para VS Code:

  • Abra o AWS Explorer e expanda o nó ECR para ver a lista de repositórios dessa AWS região.

  • Clique com o botão direito do mouse em um repositório e escolha Copy Repository URI (Copiar URI do repositório) para copiar o link para a área de transferência.

Você especifica o URI para o repositório de imagens ao configurar a instância de serviço com a paleta de comandos do VS Code

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 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 GitHub a. 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 a Paleta de Comando do VS Code.

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 o arquivo de configuração do App Runner no formato YAML. Os valores desse arquivo instruem o App Runner sobre como compilar e iniciar o serviço e fornecem o contexto do tempo de execução. 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 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