ID da região
O REGION_ID
é um código abreviado que o Google atribui
com base na região que você selecionou ao criar o aplicativo. O código não
corresponde a um país ou estado, ainda que alguns IDs de região sejam semelhantes
aos códigos de país e estado geralmente usados. A inclusão de
REGION_ID.r
em URLs do App Engine é opcional para
aplicativos atuais. Em breve, será necessária para todos os aplicativos novos.
Para garantir uma transição tranquila, estamos atualizando o App Engine gradativamente para usar IDs de região. Se ainda não tivermos atualizado seu projeto do Google Cloud, você não verá um ID da região para o app. Como o ID é opcional para os apps atuais, não é necessário atualizar os URLs ou fazer outras alterações quando o ID da região está disponível para eles.
Saiba mais sobre IDs de região.
Neste guia de início rápido, você aprenderá a criar um pequeno app do App Engine que exibe uma mensagem curta.
Antes de começar
Antes de executar e implantar este guia de início rápido, instale o SDK do Cloud e configure um projeto do Cloud para o App Engine:
Faça o download e instale o SDK do Cloud:
Observação: se o SDK do Cloud já estiver instalado, atualize-o executando o comando a seguir:gcloud components update
Crie um novo projeto:
gcloud projects create [YOUR_PROJECT_ID] --set-as-default
Substitua
[YOUR_PROJECT_ID]
por uma string de caracteres que identifique seu projeto de maneira exclusiva. Por exemplo,my-project-24
.A sinalização
--set-as-default
define o novo projeto como o padrão usado porgcloud
.Verifique se o projeto foi criado:
gcloud projects describe [YOUR_PROJECT_ID]
Você verá detalhes do projeto parecidos com o seguinte:
createTime: year-month-hour lifecycleState: ACTIVE name: project-name parent: id: '433637338589' type: organization projectId: project-name-id projectNumber: 499227785679
Inicialize seu aplicativo do App Engine com o projeto e escolha a região:
gcloud app create --project=[YOUR_PROJECT_ID]
Quando solicitado, selecione a região em que o aplicativo do App Engine estará localizado.
Verifique se o faturamento está ativado no projeto. Uma conta de faturamento precisa estar vinculada ao projeto para que o aplicativo seja implantado no App Engine.
A implantação de ambiente flexível gerará custos enquanto estiver ativa. Limpe o projeto quando terminar para evitar custos contínuos.
Instale os pré-requisitos a seguir:
- Faça o download do Git e instale-o (em inglês).
Locais do App Engine
O App Engine é regional. Isso significa que a infraestrutura que executa os aplicativos está em uma determinada região que é gerenciada pelo Google para estar disponível de modo redundante em todas as zonas dessa região.
Atender aos requisitos de latência, disponibilidade ou durabilidade são os principais fatores para selecionar a região de execução dos aplicativos. Geralmente, é possível selecionar a região mais próxima dos usuários do aplicativo, mas considere os locais em que o App Engine está disponível, bem como os locais dos outros produtos e serviços do Google Cloud usados pelo app. O uso de serviços em vários locais pode afetar a latência e o preço do aplicativo.
Não é possível alterar a região de um aplicativo depois de defini-la.
Se você já criou um aplicativo do App Engine, será possível ver a região dele com um dos seguintes procedimentos:
Execute o comando
gcloud app describe
.Abra o Painel do App Engine no Console do Cloud. A região aparece perto do topo da página.
Download do app Hello World
Criamos um aplicativo Hello World simples para Ruby. Assim, já é possível ter uma ideia de como implantar um aplicativo no Google Cloud.
Clone o repositório do app de amostra Hello World na máquina local.
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
Outra opção é fazer o download da amostra (em inglês) como um arquivo ZIP e extraí-lo.
Acesse o diretório que contém o código de amostra.
cd ruby-docs-samples/appengine/hello_world
Executar o Hello World na máquina local
Neste exemplo, o Bundler (em inglês) é usado para executar o aplicativo Hello World no seu computador local:
Se você ainda não tiver a linguagem de programação Ruby instalada, faça o download dela e instale-a.
Fazer o download e instalar o Ruby (em inglês)
Instale o Bundler (em inglês).
gem install bundler
Instale as dependências desse projeto:
bundle install
Inicie um servidor da Web local.
bundle exec ruby app.rb -p 8080
Em seu navegador da Web, digite:
A mensagem Hello World do aplicativo de amostra é exibida na página. Na janela do terminal, pressione Ctrl+C para sair do servidor da Web.
Implantar e executar o Hello World no App Engine
Para implantar o app Hello World no ambiente flexível do App Engine:-
Implemente o aplicativo Hello World executando o comando a seguir no diretório
hello_world
:gcloud app deploy
Saiba mais sobre sinalizações opcionais.
Sinalizações comuns do comando
gcloud
- Inclua a sinalização
--version
para especificar um ID exclusivo da versão do seu aplicativo. Quando a sinalização não é incluída, o ID é gerado automaticamente. Exemplo:--version [YOUR_VERSION_ID]
-
Inclua a sinalização
--project
para especificar um ID de projeto alternativo do Cloud para o que você inicializou como padrão na ferramentagcloud
. Exemplo:--project [YOUR_PROJECT_ID]
Exemplo:
gcloud app deploy --version pre-prod-5 --project my-sample-app
Para aprender a implantar o app pela linha de comando, consulte Como testar e implantar o app. Para uma lista de todas as sinalizações de comando, consulte a referência do
gcloud app deploy
. - Inclua a sinalização
-
Inicie o navegador para visualizar o aplicativo em
https://PROJECT_ID.REGION_ID.r.appspot.com
gcloud app browse
em quePROJECT_ID
representa o ID do projeto do Google Cloud.
Nesse momento, a página que exibe a mensagem "Hello World" é enviada por um servidor da Web executado em uma instância do App Engine.
Parabéns! Você implantou seu primeiro aplicativo do Ruby no ambiente flexível do App Engine.
Se você encontrar erros na implantação do app, verifique as dicas de solução de problemas.Veja as seções a seguir para informações sobre limpeza e links das próximas etapas.
Limpar
Exclua o projeto do Google Cloud para não ser cobrado pelos recursos usados nele.
- No Console do Cloud, acesse a página Gerenciar recursos:
- Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
- Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.
A seguir
Conheça a plataforma inteira
Agora que você sabe como é desenvolver e implantar aplicativos do App Engine, explore o restante do Google Cloud. Você já tem o SDK do Cloud instalado, que oferece as ferramentas para interagir com produtos como Cloud SQL, Cloud Storage, Firestore e muito mais.
Para ver um passo a passo sobre como criar um aplicativo que usa toda a plataforma, em vez de somente o App Engine, confira nosso guia de início rápido sobre a criação do app Bookshelf.
Saiba mais sobre o ambiente flexível do App Engine
Listamos alguns tópicos para você continuar aprendendo sobre o App Engine.
Revisão do código do Hello World
O Hello World é o app mais simples possível do App Engine. Nele, há apenas um serviço e uma versão, e todo o código é armazenado no diretório raiz. Nesta seção, cada arquivo do app é descrito em detalhes.
app.rb
O aplicativo Hello World é um aplicativo Sinatra básico de um arquivo:
app.yaml
O arquivo app.yaml
descreve a configuração de implantação do app:
Neste caso,
app.yaml
especifica o ambiente de execução usado
pelo app e configura o env: flex
, que determina
o uso do
ambiente flexível.
Consulte este artigo para mais informações sobre o ambiente de execução do Ruby.
Para aprender a projetar seu app para aproveitar mais as versões e os serviços, consulte Visão geral do App Engine.
Para mais detalhes sobre as configurações do App Engine, consulte Como configurar um app com o arquivo app.yaml.
Gemfile
O Gemfile
é usado para especificar as dependências de
RubyGem
do aplicativo, e o
Bundler
para declarar e instalar as dependências. O aplicativo Hello World
requer uma gem do Ruby, que é o framework da Web
Sinatra
(todos em inglês):