Guia de início rápido para Node.js no ambiente flexível do App Engine

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.

OK

Python |Java |Node.js |Go |Ruby |PHP |.NET

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

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

4. Ative a Cloud Build API.

   Ative a API

5. Instale e inicialize o SDK do Cloud..

6. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

7. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

8. Ative a Cloud Build API.

   Ative a API

9. Instale e inicialize o SDK do Cloud..

Pré-requisitos adicionais

1. 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 você quer localizar o aplicativo do App Engine.

   Cuidado: não é possível alterar a região de um aplicativo depois de defini-la.

2. Instale os pré-requisitos a seguir:

   • Faça o download e instale o Git.
   • Prepare o ambiente para desenvolvimento em Node.js.

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.

Observação: dois locais, chamados europe-west e us-central nos comandos do App Engine e no Console do Google Cloud, são chamados europe-west1 e us-central1, respectivamente, em todos os outros lugares da documentação do Google.

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.

OK

Neste início rápido, é demonstrado um aplicativo simples do Node.js escrito com a biblioteca Express.js.

Importante: para ter a melhor experiência no Windows, faça upgrade para a versão mais recente do gerenciador de pacotes Node.js (npm) executando npm install -g npm. O npm mais recente instala dependências em uma estrutura de diretório simples. Por isso, é improvável que as instalações entrem em conflito com o tamanho máximo do caminho do Windows, que é de 255 caracteres. Caso queira continuar usando uma versão mais antiga do npm, reduza o tamanho dos caminhos. Para isso, mova o projeto para a raiz do drive, por exemplo, C:\.

Download do app Hello World

Criamos um app Hello World simples para Node.js. Assim, é possível ter uma ideia rápida de como implantar um aplicativo no Google Cloud.

1. Clone o repositório do app de amostra Hello World na máquina local.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
   

   Outra opção é fazer o download da amostra (em inglês) como um arquivo ZIP e extraí-lo.

2. Acesse o diretório que contém o código de amostra.

   cd nodejs-docs-samples/appengine/hello-world/flexible
   

Como executar o Hello World na máquina local

1. Instale as dependências para o projeto.

   npm install
   

   ou, se você usa o Yarn:

   yarn install
   

2. Execute o script de inicialização:

   npm start
   

   ou, se você usa o Yarn:

   yarn start
   

3. Veja seu aplicativo no navegador da Web:

   • Se você estiver usando o Cloud Shell, clique em Visualização da Web na barra de ferramentas e selecione Visualizar na porta 8080.

   • Se você não estiver usando o Cloud Shell, digite o endereço a seguir:

   http://localhost:8080

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:

1. Implemente o aplicativo Hello World executando o comando a seguir no diretório hello-world/flexible:

   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 ferramenta gcloud. 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.

   OK
   Observação: durante a implantação, npm install é usado por padrão para instalar dependências, a menos que exista um arquivo yarn.lock não listado na seção app.yaml do arquivo skip_files. Nesse caso, yarn install --production será usado. Para fazer com que o build retorne para npm install, exclua o arquivo yarn.lock ou adicione yarn.lock à seção skip_files do arquivo app.yaml.

2. Inicie o navegador para visualizar o aplicativo em https://PROJECT_ID.REGION_ID.r.appspot.com

   gcloud app browse

   em que PROJECT_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 app Node.js 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.

Cuidado: excluir um projeto tem os seguintes efeitos:
• Tudo no projeto é excluído. Se você tiver usado um projeto atual para seguir este tutorial, a exclusão dele incluirá quaisquer outras ações feitas no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.
1. No Console do Cloud, acesse a página Gerenciar recursos:

   Acessar "Gerenciar recursos"

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
3. 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.

• Uma visão geral do App Engine
• Como as solicitações são roteadas
• Como as solicitações são tratadas
• Como as instâncias são gerenciadas

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

O arquivo app.js contém o código JavaScript para iniciar um servidor e responder a solicitações.

No código a seguir, as solicitações de clientes Web são respondidas com a mensagem "Hello World", por meio de um servidor executado na porta 8080.

appengine/hello-world/flexible/app.js

Ver no GitHub

const express = require('express');

const app = express();

app.get('/', (req, res) => {
  res.status(200).send('Hello, world!').end();
});

// Start the server
const PORT = process.env.PORT || 8080;
app.listen(PORT, () => {
  console.log(`App listening on port ${PORT}`);
  console.log('Press Ctrl+C to quit.');
});

app.yaml

O arquivo app.yaml descreve a configuração de implantação do app:

appengine/hello-world/flexible/app.yaml

Ver no GitHub

runtime: nodejs
env: flex

# This sample incurs costs to run on the App Engine flexible environment.
# The settings below are to reduce costs during testing and are not appropriate
# for production use. For more information, see:
# https://cloud.google.com/appengine/docs/flexible/nodejs/configuring-your-app-with-app-yaml
manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

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.

• Para mais informações sobre como funciona o ambiente de execução do Node.js, consulte O ambiente de execução do Node.js.

• Para aprender como 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.

package.json

package.json (em inglês) é usado para especificar dependências do app, versão do nó e inicialização do app.

appengine/hello-world/flexible/package.json

Ver no GitHub

{
  "name": "appengine-hello-world",
  "description": "Simple Hello World Node.js sample for Google App Engine Flexible Environment.",
  "version": "0.0.2",
  "private": true,
  "license": "Apache-2.0",
  "author": "Google Inc.",
  "repository": {
    "type": "git",
    "url": "https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git"
  },
  "engines": {
    "node": ">= 12.20.0"
  },
  "scripts": {
    "start": "node app.js",
    "test": "mocha --exit test/*.test.js"
  },
  "dependencies": {
    "express": "^4.17.1"
  },
  "devDependencies": {
    "mocha": "^9.0.0",
    "supertest": "^6.0.0"
  }
}

No exemplo anterior, o arquivo package.json especifica que o app usa Node.js v12.20.0 ou mais recente, depende do express e que node app.js é usado para iniciar o app. A versão do Node.js especificada no app pode usar a versão especificada ou mais recente. Para mais detalhes sobre como instalar e executar o app, consulte a documentação do ambiente de execução do Node.js.