Construção de um URL "Iniciar agora"

Você pode criar um localizador uniforme de recursos (URL) personalizado para que qualquer pessoa possa implantar e executar rapidamente uma aplicação Web predeterminada no AWS Elastic Beanstalk. Esse URL é chamado URL "Iniciar agora". Você pode precisar de um URL de início imediato, por exemplo, para demonstrar uma aplicação Web criada para ser executada no Elastic Beanstalk. Com a URL Launch Now (Iniciar agora), você pode usar parâmetros para adicionar antecipadamente as informações necessárias ao assistente de criação de aplicativo. Quando adiciona essa informação no assistente, qualquer pessoa pode usar o link do URL para iniciar um ambiente do Elastic Beanstalk com a fonte da aplicação Web em apenas algumas etapas. Isso significa que os usuários não precisam carregar ou especificar manualmente o local do pacote de origem da aplicação. Também não é necessário fornecer nenhuma informação adicional ao assistente.

Um URL de início imediato fornece ao Elastic Beanstalk as informações mínimas necessárias para criar uma aplicação: o nome da aplicação, a pilha de soluções, o tipo de instância e o tipo de ambiente. O Elastic Beanstalk usa valores padrão para os outros detalhes de configuração que não são explicitamente especificados no URL personalizado de início imediato.

Um URL "Iniciar agora" usa a sintaxe de URL padrão. Para obter mais informações, consulte RFC 3986 – URI (Uniform Resource Identifier): sintaxe genérica.

Parâmetros do URL

O URL deve conter os seguintes parâmetros, que diferenciam maiúsculas de minúsculas:

• region (região): especifique uma região da AWS Para obter uma lista de regiões compatíveis com o Elastic Beanstalk, consulte AWS Elastic BeanstalkEndpoints e cotas no Referência geral da AWS.

• applicationName: especifique o nome da aplicação. O Elastic Beanstalk exibe o nome da aplicação no console do Elastic Beanstalk para distingui-la de outras aplicações. Por padrão, o nome do aplicativo também forma a base do nome e URL do ambiente.

• platform (plataforma): especifique a versão de plataforma a ser usada para o ambiente. Use um dos métodos a seguir e codifique sua escolha com URL:

  • Especifique um ARN de plataforma sem uma versão. O Elastic Beanstalk seleciona a versão da plataforma mais recente da versão principal da plataforma correspondente. Por exemplo, para selecionar a versão mais recente da plataforma Python 3.6, especifique Python 3.6 running on 64bit Amazon Linux.

  • Especifique o nome da plataforma. O Elastic Beanstalk seleciona a versão mais recente do tempo de execução mais recente do idioma da plataforma (por exemplo, Python).

  Para obter uma descrição de todas as plataformas disponíveis e suas versões, consulte Plataformas compatíveis com Elastic Beanstalk.

  Você pode usar a AWS Command Line Interface (AWS CLI) para obter uma lista de todas as versões da plataforma disponíveis com seus respectivos ARNs. O comando list-platform-versions lista informações detalhadas sobre todas as versões da plataforma disponíveis. Use o argumento --filters para limitar o escopo da lista. Por exemplo, você pode listar todas as versões da plataforma de um idioma específico.

  O exemplo a seguir consulta todas as versões de plataforma Python e canaliza a saída por meio de uma série de comandos. O resultado é uma lista de ARNs de versão da plataforma (sem o final /version), em formato legível, sem codificação de URL.

  $ aws elasticbeanstalk list-platform-versions --filters 'Type="PlatformName",Operator="contains",Values="Python"' | grep PlatformArn | awk -F '"' '{print $4}' | awk -F '/' '{print $2}'
  Preconfigured Docker - Python 3.4 running on 64bit Debian
  Preconfigured Docker - Python 3.4 running on 64bit Debian
  Python 2.6 running on 32bit Amazon Linux
  Python 2.6 running on 32bit Amazon Linux 2014.03
  ...
  Python 3.6 running on 64bit Amazon Linux

  O exemplo a seguir adiciona um comando Perl ao último exemplo, para codificar a saída com URL.

  $ aws elasticbeanstalk list-platform-versions --filters 'Type="PlatformName",Operator="contains",Values="Python"' | grep PlatformArn | awk -F '"' '{print $4}' | awk -F '/' '{print $2}' | perl -MURI::Escape -ne 'chomp;print uri_escape($_),"\n"'
  Preconfigured%20Docker%20-%20Python%203.4%20running%20on%2064bit%20Debian
  Preconfigured%20Docker%20-%20Python%203.4%20running%20on%2064bit%20Debian
  Python%202.6%20running%20on%2032bit%20Amazon%20Linux
  Python%202.6%20running%20on%2032bit%20Amazon%20Linux%202014.03
  ...
  Python%203.6%20running%20on%2064bit%20Amazon%20Linux

Um URL "Iniciar agora" pode, opcionalmente, conter os parâmetros a seguir. Se você não incluir os parâmetros opcionais em seu URL Launch Now (Iniciar agora), o Elastic Beanstalk usará valores padrão para criar e executar a aplicação. Quando o parâmetro sourceBundleUrl é incluído, o Elastic Beanstalk usa a aplicação demonstrativa padrão para a plataforma (plataforma) especificada.

• sourceBundleUrl: especifique o local do pacote de origem da aplicação Web no formato de URL. Por exemplo, se você fez upload do pacote de origem em um bucket do Amazon S3, poderá especificar o valor do parâmetro sourceBundleUrl como https://mybucket.s3.amazonaws.com/myobject.

  nota

  Você pode especificar o valor do parâmetro sourceBundleUrl como um URL HTTP, mas o navegador da Web do usuário converterá caracteres, conforme necessário, aplicando a codificação de URL HTML.

• environmentType: especifique se o ambiente tem balanceamento de carga e é escalável ou se é de apenas uma única instância. Para obter mais informações, consulte Tipos de ambiente. Você pode especificar LoadBalancing ou SingleInstance como o valor do parâmetro.

• tierName: especifique se o ambiente é compatível com uma aplicação Web que processe solicitações da Web ou com uma aplicação Web que execute trabalhos em segundo plano. Para obter mais informações, consulte Ambientes de operador do Elastic Beanstalk. Você pode especificar WebServer ou Worker,

• instanceType: especifique um servidor com as características (incluindo o tamanho da memória e a capacidade da CPU) mais adequadas à aplicação. Para obter mais informações sobre as famílias e os tipos de instância do Amazon EC2, consulte Tipos de instância, no Guia do usuário do Amazon EC2 para instâncias do Linux ou Tipos de instância no Guia do usuário do Amazon EC2 para instâncias do Windows. Para obter mais informações sobre os tipos de instâncias disponíveis nas regiões, consulte Tipos de instância no Guia do usuário do Amazon EC2 para instâncias do Linux ou tipos de instância no Guia do usuário do Amazon EC2 para instâncias do Windows.

• withVpc: especifique se o ambiente será criado em uma Amazon VPC. Você pode especificar true ou false. Para obter mais informações sobre como usar o Elastic Beanstalk com a Amazon VPC, consulte Usar o Elastic Beanstalk com Amazon VPC.

• withRds: especifique uma instância do banco de dados do Amazon RDS será criada com esse ambiente. Para obter mais informações, consulte Usar o Elastic Beanstalk com o Amazon RDS. Você pode especificar true ou false.

• rdsDBEngine: especifique o mecanismo de banco de dados que deseja usar em suas instâncias do Amazon EC2 nesse ambiente. Especifique mysql, oracle-sel, sqlserver-ex, sqlserver-web ou sqlserver-se. O valor padrão é mysql.

• rdsDBAllocatedStorage: especifique o tamanho alocado de armazenamento do banco de dados em gigabytes (GB). Especifique os seguintes valores:

  • MySQL: 5 a 1024. O padrão é 5.

  • Oracle: 10 a 1024. O padrão é 10.

  • Microsoft SQL Server Express Edition – 30.

  • Microsoft SQL Server Web Edition – 30.

  • Microsoft SQL Server Standard Edition – 200.

• rdsDBInstanceClass: especifique o tipo de instância de banco de dados. O valor padrão é db.t2.micro (db.m1.large é para um ambiente que não esteja em execução em uma Amazon VPC). Para obter uma lista de classes de instância de banco de dados suportadas pelo Amazon RDS, consulte DB Instance Class (Classe de instância de banco de dados) no Amazon Relational Database Service User Guide (Guia do usuário do Amazon Relational Database Service).

• rdsMultiAZDatabase: especifique se o Elastic Beanstalk precisa criar a instância de banco de dados em várias zonas de disponibilidade. Você pode especificar true ou false. Para obter mais informações sobre implantações em várias zonas de disponibilidade com o Amazon RDS, acesse Regions and Availability Zones (Regiões e zonas de disponibilidade) no Amazon Relational Database Service User Guide (Guia do usuário do Amazon Relational Database Service).

• rdsDBDeletionPolicy: especifique se deseja excluir ou criar um snapshot da instância de banco de dados no encerramento do ambiente. Você pode especificar Delete ou Snapshot.

Exemplo

Um exemplo de URL "Iniciar agora" está apresentado a seguir. Depois de criar seu próprio URL, você pode fornecê-lo aos usuários. Por exemplo, você pode incorporar a URL em uma página da Web ou em materiais de treinamento. Quando os usuários criam uma aplicação usando o URL Launch Now (Iniciar agora), o assistente de criação de aplicação do Elastic Beanstalk não requer entrada adicional.

https://console.aws.amazon.com/elasticbeanstalk/home?region=us-west-2#/newApplication?applicationName=YourCompanySampleApp&platform=PHP%207.3%20running%20on%2064bit%20Amazon%20Linux&sourceBundleUrl=http://s3.amazonaws.com/mybucket/myobject&environmentType=SingleInstance&tierName=WebServer&instanceType=m1.small&withVpc=true&withRds=true&rdsDBEngine=postgres&rdsDBAllocatedStorage=6&rdsDBInstanceClass=db.m1.small&rdsMultiAZDatabase=true&rdsDBDeletionPolicy=Snapshot

Quando os usuários escolhem um URL Launch Now (Iniciar agora), o Elastic Beanstalk exibe uma página semelhante à seguinte.

Para usar o URL "Iniciar agora"

1. Escolha a URL Launch Now (Iniciar agora).

2. Quando o console do Elastic Beanstalk é aberto, na página Create a web app (Criar uma aplicação Web), escolha Review and launch (Revisar e iniciar) para visualizar as configurações que o Elastic Beanstalk usa para criar a aplicação e iniciar o ambiente no qual a aplicação é executada.

3. Na página Configure (Configurar), clique em Create app (Criar aplicativo) para criar o aplicativo.