Guia de início rápido: criar um aplicativo Node.js no ambiente padrão do App Engine

Criar um aplicativo Node.js no ambiente padrão 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. Para apps criados após fevereiro de 2020, o REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criados antes dessa data, o ID da região é opcional no URL.

Saiba mais sobre IDs de região.

Neste guia de início rápido, você aprende como implantar um aplicativo de amostra no App Engine. Se você quiser saber mais sobre como codificar um app para o App Engine, consulte Como criar um app.

O App Engine é a opção de computação certa para você? Veja outras opções para hospedar seu aplicativo no Google Cloud.

Custos

Não há custos associados à execução deste guia. A execução deste aplicativo de amostra não excede sua cota gratuita.

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.

    Acessar o seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. Ative a Cloud Build API.

    Ative a API

  5. Instale a CLI do Google Cloud.

  6. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init
    7.

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

    Acessar o seletor de projetos

  8. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  9. Ative a Cloud Build API.

    Ative a API

  10. Instale a CLI do Google Cloud.

  11. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init
    12.

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.

  2. Instale os pré-requisitos a seguir:

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:

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

Faça o download do código de amostra

Use nosso app Hello World para ter uma visão geral rápida da implantação de um serviço da Web no App Engine. Siga estas etapas para fazer o download do código para seu ambiente de desenvolvimento:

  1. Faça o download do repositório de apps de amostra do Node.js:

    Cloud Shell

    Abra o repositório no Cloud Shell:

    Abrir no Cloud Shell

    Máquina local

    Faça o download do repositório como um arquivo ZIP e extraia-o.

    Como alternativa, clone o repositório com git:

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

  2. Mude para o diretório que contém o app Hello World:

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

Executar o Hello World na máquina local

  1. Instale as dependências para o projeto:

    npm install

  2. Inicie o servidor HTTP:

    npm start

  3. Veja seu app no navegador da Web:

    Cloud Shell

    Na barra de ferramentas do Cloud Shell, clique em Visualização da Web Visualização da Web e selecione Visualizar na porta 8080.

    Máquina local

    Aponte seu navegador da Web para http://localhost:8080.

    Você pode ver a mensagem "Hello, world!" exibida na página.

  4. Interrompa o servidor HTTP pressionando Ctrl + C na janela do terminal.

Implante e execute o Hello World no App Engine

  1. Implante o aplicativo Hello World no App Engine executando o seguinte comando no diretório hello-world/standard:

    gcloud app deploy

  2. Veja o app ativo em https://PROJECT_ID.REGION_ID.r.appspot.com:

    gcloud app browse

A mensagem "Hello, world!" agora é entregue por um servidor da Web em execução em uma instância do App Engine.

Parabéns! Você implantou com sucesso um serviço da Web em Node.js no App Engine.

Limpeza

Se você quiser continuar aprendendo sobre o App Engine, armazene seu projeto do Cloud e acompanhe Como criar um aplicativo.

Como alternativa, é possível excluir seu projeto do Cloud para interromper o faturamento de todos os recursos usados nesse projeto.

  1. No Console do Google 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

Agora que você já sabe implantar um serviço da Web no App Engine, veja mais detalhes sobre o Node.js no App Engine no artigo Como criar um aplicativo.

Para mais informações sobre o ambiente de execução do Node.js no App Engine, consulte este link.