Adição de aplicativos - AWS OpsWorks

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

Adição de aplicativos

Importante

O AWS OpsWorks Stacks serviço chegou ao fim da vida útil em 26 de maio de 2024 e foi desativado para clientes novos e existentes. É altamente recomendável que os clientes migrem suas cargas de trabalho para outras soluções o mais rápido possível. Se você tiver dúvidas sobre migração, entre em contato com a AWS Support equipe no AWS re:POST ou por meio do Premium AWS Support.

A primeira etapa na implantação de um aplicativo nos seus servidores de aplicativos é a adição do aplicativo na pilha. O aplicativo representa o programa e contém uma variedade de metadados, como o nome e o tipo do aplicativo e as informações necessárias para implantar o aplicativo nas instâncias do servidor, como o URL do repositório. Você precisa ter a permissão Manage para adicionar um aplicativo a uma pilha. Para ter mais informações, consulte Gerenciamento de permissões de usuário.

nota

O procedimento descrito nesta seção se aplica a pilhas do Chef 12 e mais recentes. Para obter mais informações sobre como adicionar aplicativos a camadas nas pilhas do Chef 11, consulte Etapa 2.4: Criar e implantar um aplicativo - Chef 11.

Para adicionar um aplicativo a uma pilha
  1. Coloque o código no repositório de sua preferência: um arquivo compactado do Amazon S3, um repositório Git, um repositório Subversion ou um arquivo compactado HTTP. Para ter mais informações, consulte Origem do aplicativo.

  2. No painel de navegação, clique em Apps. Na página Apps, clique em Add an app no seu primeiro aplicativo. Para os aplicativos subsequentes, clique em +App.

  3. Use a página App New para configurar o aplicativo, como descreve a seção a seguir.

Configuração do aplicativo

A página Add App consiste nas seguintes seções: Settings, Application source, Data Sources, Environment Variables, Add Domains e SSL Settings.

Configurações

Nome

O nome do aplicativo, que é usado para representar o aplicativo na interface do usuário. AWS OpsWorks O Stacks também usa esse nome para gerar um nome curto para o aplicativo usado internamente e para identificar o aplicativo nos atributos de configuração e implantação da pilha. Depois de adicionar o aplicativo à pilha, você pode ver o nome abreviado clicando em Apps no painel de navegação e, em seguida, clicando no nome do aplicativo para abrir a página de detalhes.

Document root

AWS OpsWorks Stacks atribui a configuração raiz do documento ao [:document_root]atributo nos atributos do deploy aplicativo. O valor padrão é null. Suas receitas de implantação podem obter esse valor dos atributos deploy usando a sintaxe do nó padrão do Chef e implantar o código especificado no local apropriado do servidor. Para obter mais informações sobre como implantar aplicativos, consulte Receitas de implantação.

Origem do aplicativo

Você pode implantar aplicativos dos seguintes tipos de repositório: Git, pacote do Amazon S3, pacote de HTTP e outros. Todos os tipos de repositórios exigem que você especifique o tipo e o URL do repositório. Tipos de repositórios individuais têm seus próprios requisitos, como explicamos a seguir.

nota

AWS OpsWorks O Stacks implanta automaticamente aplicativos dos repositórios padrão nas camadas integradas do servidor. Se você usa o tipo Outro repositório, que é a única opção para pilhas do Windows, o AWS OpsWorks Stacks coloca as informações do repositório nos deployatributos do aplicativo, mas você deve implementar receitas personalizadas para lidar com as tarefas de implantação.

Arquivo HTTP

Para usar um servidor HTTP de acesso público como um repositório:

  1. Crie um arquivo compactado do tipo zip, gzip, bzip2, Java WAR ou tarball com o conteúdo da pasta que contém o código do aplicativo e quaisquer arquivos associados.

    nota

    AWS OpsWorks O Stacks não suporta arquivos tar não compactados.

  2. Carregue o arquivo compactado no servidor.

  3. Para especificar o repositório no console, selecione HTTP Archive como tipo do repositório e insira o URL.

    Se o arquivo compactado é protegido por senha, especifique as credenciais de entrada em Fonte do aplicativo.

Arquivo do Amazon S3

Crie um bucket do Amazon Simple Storage Service como um repositório:

  1. Crie um bucket público ou privado no Amazon S3. Para mais informações, consulte a documentação do Amazon S3.

  2. Para que o AWS OpsWorks Stacks acesse buckets privados, você deve ser um usuário com pelo menos direitos de somente leitura no bucket do Amazon S3 e precisará do ID da chave de acesso e da chave de acesso secreta. Para obter mais informações, consulte a Documentação do AWS Identity and Access Management.

  3. Coloque o código e quaisquer arquivos associados em uma pasta e armazene a pasta em um arquivo compactado – zip, gzip, bzip2, Java WAR ou tarball.

    nota

    AWS OpsWorks O Stacks não suporta arquivos tar não compactados.

  4. Carregue o arquivo compactado no bucket do Amazon S3 e anote o URL.

  5. Para especificar o repositório no console AWS OpsWorks Stacks, defina o tipo de repositório como S3 Archive e insira a URL do arquivo. Para arquivos compactados privados, você também deve fornecer um access key ID e a chave de acesso secreta da AWS cuja política concede as permissões para acessar o bucket. Deixe essas configurações em branco para arquivos compactados públicos.

Repositório Git

Um repositório Git fornece controle de origem e controle de versão. AWS OpsWorks O Stacks oferece suporte a sites de repositórios hospedados publicamente, como GitHubo Bitbucket, bem como a servidores Git hospedados de forma privada. Para ambos os aplicativos e os submódulos do Git, o formato que você usa para especificar o URL do repositório em Application Source depende se o repositório é público ou privado:

Repositório público: use os protocolos HTTPS ou Git somente de leitura. Por exemplo, Conceitos básicos das pilhas Linux do Chef 11 usa um GitHub repositório público que pode ser acessado por qualquer um dos seguintes formatos de URL:

  • Somente leitura do Git: git://github.com/amazonwebservices/opsworks-demo-php-simple-app.git

  • HTTPS: https://github.com/amazonwebservices/opsworks-demo-php-simple-app.git

Repositório privado: use o formato de leitura/gravação do SSH como mostram os exemplos a seguir:

  • Repositórios Github: git@github.com:project/repository.

  • Repositórios em um servidor Git: user@server:project/repository

Ao selecionar Git em Source Control, duas configurações opcionais adicionais são exibidas:

Chave SSH de repositório

Você deve especificar uma chave SSH de implantação para acessar os repositórios Git privados. Esse campo requer a chave privada; a chave pública é atribuída ao seu repositório Git. Para submódulos do Git, a chave especificada deve ter acesso a esses submódulos. Para ter mais informações, consulte Utilização de chaves SSH de repositório Git.

Importante

A chave SSH de implantação não pode exigir uma senha; o AWS OpsWorks Stacks não tem como passá-la.

Ramificação/Revisão

Se o repositório tiver várias ramificações, o AWS OpsWorks Stacks baixa a ramificação master por padrão. Para especificar uma determinada ramificação, insira o nome da ramificação, o hash SHA1 ou nome da tag. Para especificar uma determinada confirmação, insira o identificador completo de confirmação de 40 dígitos hexadecimais.

Outros repositórios

Se os repositórios padrão não atendem aos seus requisitos, você pode usar outros repositórios, como o Bazaar. No entanto, o AWS OpsWorks Stacks não implanta automaticamente aplicativos desses repositórios. Você deve implementar receitas personalizadas para lidar com o processo de implantação e atribuí-las aos eventos de implantação das camadas apropriadas. Para ver um exemplo de como implementar o Implantar receitas, consulte Receitas de implantação.

Fontes de dados

Esta seção mostra como anexar um banco de dados no aplicativo. Você tem as seguintes opções:

  • RDS: anexe uma das camadas de serviço do Amazon RDS da pilha.

  • Nenhum: não anexe um servidor de banco de dados.

Se você selecionar RDS, precisará especificar o seguinte.

Instância do banco de dados

A lista inclui todas as camadas de serviço do Amazon RDS. Você também pode selecionar um dos seguintes:

(Obrigatório) especifique o servidor de banco de dados a ser anexado ao aplicativo. O conteúdo da lista depende da fonte de dados.

  • RDS: uma lista das camadas de serviço do Amazon RDS da pilha.

Database name

(Opcional) especifique um nome de banco de dados.

  • Camada do Amazon RDS: insira o nome do banco de dados que você especificou para a instância do Amazon RDS.

    Você pode obter o nome do banco de dados do console do Amazon RDS.

Quando você implanta um aplicativo com um banco de dados anexado, o AWS OpsWorks Stacks adiciona a conexão da instância do banco de dados aos deployatributos do aplicativo.

Você pode criar uma receita personalizada para recuperar as informações dos atributos deploy e colocá-la no arquivo que pode ser acessado pelo aplicativo. Esta é a única opção para fornecer informações de conexão de banco de dados ao tipo de aplicativo Outros.

Para obter mais informações sobre como lidar com conexões de banco de dados, consulte Conectar-se a um banco de dados.

Para desanexar um servidor de banco de dados de um aplicativo, edite a configuração do aplicativo para especificar um servidor de banco de dados diferente ou nenhum servidor.

Variáveis de ambiente

Você pode especificar um conjunto de variáveis de ambiente para cada aplicativo, que são específicas para o aplicativo. Por exemplo, se você tiver dois aplicativos, as variáveis de ambiente que você define para o primeiro aplicativo não são disponibilizadas para o segundo aplicativo e vice-versa. Você também pode definir a mesma variável de ambiente para vários aplicativos e atribuir a ela um valor diferente para cada aplicativo.

nota

Não há um limite específico para o número de variáveis de ambiente. No entanto, o tamanho da estrutura de dados associada, que inclui os nomes e valores das variáveis e os valores de sinalização protegidos, não pode ultrapassar 20 KB. Esse limite deve acomodar a maioria dos casos de uso. Se o limite for ultrapassado, isso causará um erro de serviço (console) ou exceção (API) com a mensagem, "Ambiente: é muito grande (o tamanho máximo é 20 KB)."

AWS OpsWorks O Stacks armazena as variáveis como atributos nos deployatributos do aplicativo. Você pode fazer com que suas receitas personalizadas recuperem esses valores usando a sintaxe padrão do nó do Chef. Para obter exemplos de como acessar as variáveis de ambiente de um aplicativo, consulte Usar variáveis de ambiente do .

Chave

O nome da variável. Ele pode conter até 64 letras maiúsculas e minúsculas, números e caracteres sublinhados (_), mas deve começar com uma letra ou sublinhado.

Valor

O valor da variável. Ele pode conter até 256 caracteres, que devem ser todos imprimíveis.

Valor protegido

Determina se o valor é protegido. Essa configuração permite que você oculte informações confidenciais, como senhas. Se você definir uma variável como Protected value depois de criar o aplicativo:

  • A página de detalhes do aplicativo exibirá somente o nome da variável, e não o valor.

  • Se você tiver permissão para editar o aplicativo, pode clicar em Update value para especificar um novo valor, mas não poderá ver ou editar o valor antigo.

nota

Às vezes, os logs de implantação do Chef podem incluir variáveis de ambiente. Isso significa que as variáveis protegidas podem ser exibidas no console. Para evitar que isso ocorra, recomendamos que você use buckets do Amazon S3 como armazenamento para variáveis protegidas que você não deseja que sejam exibidas no console. Um exemplo de como usar um bucket do S3 para essa finalidade está disponível em Usar um bucket do Amazon S3 neste guia.

Configurações de Domínio e SSL

Para o tipo de aplicativo Outro, o AWS OpsWorks Stacks adiciona as configurações aos deploy atributos do aplicativo. Suas receitas podem recuperar os dados a partir desses atributos e configurar o servidor, conforme necessário.

Configurações de domínio

Esta seção tem um campo opcional Add Domains para especificar domínios. Para ter mais informações, consulte Usando domínios predefinidos.

Configurações de SSL

Esta seção tem uma opção de alternância de SSL Support que você pode usar para habilitar ou desabilitar o SSL. Se você clicar em Yes, precisará fornecer as informações do certificado SSL. Para ter mais informações, consulte Uso de SSL.