Dê os primeiros passos no desenvolvimento de aplicativos Ruby on Rails executados no ambiente flexível do App Engine. Os aplicativos que você cria são executados na mesma infraestrutura que capacita todos os produtos do Google. Assim, você tem a certeza de que eles são escalonados para suprir todos os usuários, sejam eles poucos ou milhões.
Para acompanhar o tutorial, é preciso conhecer o desenvolvimento do Rails para a Web. Nele, você verá as etapas de implantação de um novo aplicativo do Rails.
Este tutorial requer o Ruby 2.6 ou 2.7.
Antes de começar
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Configurar o ambiente local para o Rails
Para configurar o ambiente local para desenvolvimento do Rails, faça o seguinte:
Outra opção é usar o Cloud Shell, que já vem com o Ruby, o Rails e o CLI do Google Cloud instalados.
Para mais informações sobre como instalar o Rails e as respectivas dependências, consulte o guia oficial Primeiros passos com o Rails (em inglês).
Depois de concluir os pré-requisitos, é possível criar e implantar um aplicativo do Rails. Veja nas seções a seguir as etapas para configurar, executar e implantar um aplicativo.
Criar um novo aplicativo
Crie um novo app de exemplo do Rails.
rails new appengine_example
Acesse o diretório que contém a amostra do código.
cd appengine_example
Executar o aplicativo localmente
Para executar o novo aplicativo do Rails no computador local, siga estas etapas:
Instale dependências usando o Bundler.
bundle install
Inicie um servidor da Web local.
bundle exec rails server
No navegador, acesse http://localhost:3000/.
Você verá na página a mensagem "Yay! Você está no Rails!" do app de amostra exibido na página.
Adicionar uma página simples
Agora, adicione uma página de boas-vindas ao aplicativo Rails gerado.
Para gerar a estrutura de uma nova página, crie um novo controlador do Rails chamado
WelcomeController
com uma açãoindex
.bundle exec rails generate controller Welcome index
Abra o arquivo
app/views/welcome/index.html.erb
para ver o seguinte HTML padrão.Modifique o arquivo como quiser. Por exemplo, você pode usar o seguinte conteúdo:
Defina a ação do controlador
index
como a ação raiz para o Rails. Sempre que um usuário acessar o aplicativo do Rails, ele verá sua página de boas-vindas.Abra o arquivo
config/routes.rb
para ver o seguinte conteúdo gerado.Para modificar esse arquivo, adicione
root 'welcome#index'
.Salve e feche o arquivo. Teste o aplicativo do Rails como você fez antes.
Implantar o app no ambiente flexível do App Engine
O ambiente flexível do App Engine usa um arquivo denominado
app.yaml
.
para descrever a configuração de implantação de um aplicativo. Se esse arquivo não estiver presente, a CLI gcloud
tentará adivinhar a configuração de implantação. Porém, é uma boa ideia fornecer esse arquivo, porque o Rails requer uma chave secreta em um ambiente de produção.
Para configurar o aplicativo de amostra para implantação no App Engine, crie um novo
arquivo chamado app.yaml
na raiz do diretório do aplicativo e adicione o
seguinte:
Configurar a chave secreta do Rails
Ao implementar um aplicativo do Rails no ambiente de produção, defina a variável de ambiente SECRET_KEY_BASE
como uma chave secreta usada para proteger os dados da sessão do usuário. Essa variável de ambiente é lida no
arquivo config/secrets.yml
.
Gere uma nova chave secreta.
bundle exec rails secret
Copie a chave secreta gerada. Você usará essa chave na próxima etapa.
Abra o arquivo
app.yaml
criado anteriormente e adicione uma seçãoenv_variables
. Oenv_variables
define variáveis de ambiente no ambienteproduction
no ambiente flexível do App Engine. Oapp.yaml
será semelhante ao exemplo abaixo. Substitua[SECRET_KEY]
pela chave secreta na área de transferência.
Configurar um aplicativo de ambiente flexível do App Engine
Se esta for a primeira vez que você está implantando um aplicativo, é necessário criar um aplicativo de ambiente flexível do App Engine para ajudar a selecionar a região em que o aplicativo do Rails será executado. Leia mais sobre regiões e zonas.
Crie um aplicativo do App Engine. Por padrão, duas funções do comando são criadas a seguir:
gcloud app create
Selecione uma região compatível com o ambiente flexível do App Engine para aplicativos Ruby.
Implantar no ambiente flexível do App Engine
Execute o seguinte comando para implantar o app de exemplo:
gcloud app deploy
Aguarde a notificação sobre a conclusão da atualização. Isso pode demorar alguns minutos.
Acessar o aplicativo do Rails implantado
Para recuperar o ID do projeto, execute
gcloud info
.No navegador, digite o seguinte URL:
https://PROJECT_ID.REGION_ID.r.appspot.com
Substitua:
PROJECT_ID
: é o ID do projeto do Google Cloud.REGION_ID
: um código que o App Engine atribui ao aplicativo
O conteúdo a seguir é exibido.
Desta vez, sua solicitação é veiculada pelo aplicativo do Rails em execução no ambiente flexível do App Engine.
Esse comando implanta o aplicativo conforme descrito em app.yaml
e define a versão recém-implantada
como padrão. Com isso, ela veicula todo o tráfego novo.
Durante a implantação do app, várias mensagens repetidas podem ser vistas, enquanto é verificado pela plataforma se o app está veiculando. Isso é normal. Aguarde a mensagem notificando que a atualização do app foi concluída.
Para atualizar o app, implante a versão atualizada digitando o mesmo comando usado para implantá-lo pela primeira vez. A implantação cria uma nova versão do app e a define como padrão. As versões mais antigas são mantidas, bem como as instâncias de VM associadas. Lembre-se de que essas versões do aplicativo e instâncias de VM são recursos passíveis de cobrança.
Ler registros do App Engine
Agora que você já implantou o aplicativo Rails, será possível ler os registros. Para ler os registros do aplicativo, use o Explorador de registros localizado no Console do Cloud ou use gcloud app logs read
.
Saiba mais sobre como ler registros usando a CLI gcloud
.
Fazer a limpeza dos recursos
Depois de concluir o tutorial, limpe os recursos que você criou para que eles parem de usar a cota e incorrer em cobranças. Nas seções a seguir, você aprenderá a excluir e desativar esses recursos.
Excluir projeto
O jeito mais fácil de evitar cobranças é excluindo o projeto que você criou para o tutorial.
Para excluir o projeto:
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Excluir uma versão do aplicativo do App Engine
Para excluir uma versão do app:
- In the Google Cloud console, go to the Versions page for App Engine.
- Select the checkbox for the non-default app version that you want to delete.
- Para excluir a versão do app, clique em Excluir.
A seguir
Saiba como usar o Cloud SQL para MySQL com o Rails.
Saiba como usar o Cloud SQL para PostgreSQL com o Rails.
Saiba como executar a amostra do Ruby Bookshelf no ambiente flexível do App Engine.
Saiba como executar a amostra do Ruby Bookshelf no Compute Engine.
Saiba como executar a amostra do Bookshelf em Ruby no GKE.