Implemente o seu serviço Web

Nota: se estiver a implementar um novo serviço Web Node.js no Google Cloud, recomendamos que comece com o Cloud Run.

ID da região

O REGION_ID é um código abreviado que a Google atribui com base na região que seleciona quando cria a sua app. O código não corresponde a um país ou uma província, embora alguns IDs de regiões possam parecer semelhantes aos códigos de países e províncias usados frequentemente. Para apps criadas após fevereiro de 2020, REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criadas antes desta data, o ID da região é opcional no URL.

Saiba mais acerca dos IDs de regiões.

OK

Esta secção do guia mostra como usar a CLI gcloud para implementar o seu serviço Web Node.js no App Engine. Para saber mais sobre o ambiente de tempo de execução do Node.js, consulte o artigo Ambiente de tempo de execução do Node.js.

Antes de começar

1. Crie um Google Cloud projeto com uma app do App Engine.
2. Escreva um servidor Web Node.js pronto para implementação no App Engine.
3. Instale a CLI Google Cloud, que fornece a ferramenta de linha de comandos gcloud. Certifique-se de que o gcloud está configurado para usar o projeto para o qual quer fazer a implementação. Google Cloud

Pontos-chave

Use gcloud app deploy e gcloud app browse para implementar e ver o seu serviço.

Implemente o seu serviço

Na pasta my-nodejs-service, onde se encontra o ficheiro app.yaml, execute o seguinte comando no terminal:

gcloud app deploy

Em seguida, os ficheiros de origem são carregados para o Google Cloud Storage. O Cloud Build cria a sua app e implementa-a no App Engine.

Para obter informações sobre outras formas de criar e implementar a sua app, consulte o artigo Testar e implementar a sua app.

Nota: os ficheiros listados no ficheiro .gcloudignore não são carregados.

Se não tiver um, é criado um ficheiro .gcloudignore para garantir que a pasta node_modules não é carregada.

Os módulos Node.js são instalados na nuvem, conforme indicado nos ficheiros package.json e package-lock.json, e o serviço é iniciado através de npm start.

Importante: para ter o melhor desempenho, o seu script start deve ser simples, porque é executado sempre que é criada uma nova instância da sua aplicação.

Implemente vários serviços

Pode adicionar vários serviços no seu projeto criando um ficheiro app.yaml para cada serviço. Inclua o atributo service no ficheiro app.yaml para especificar o nome do serviço. Para saber como estruturar a sua app através de vários serviços, consulte o artigo Estruturar serviços Web no App Engine.

Para implementar vários serviços, siga estas instruções. Cada serviço implementado tem o seu próprio URL atribuído.

Veja o seu serviço

Para iniciar rapidamente o navegador e aceder ao seu serviço Web em https://PROJECT_ID.REGION_ID.r.appspot.com, use o seguinte comando:

gcloud app browse

Serviços e versões

Acabou de criar e implementar um serviço no App Engine. Pode especificar o nome do seu serviço no ficheiro app.yaml. Se o nome for omitido, é tratado como default. O primeiro serviço que implementar tem de ser o serviço predefinido.

Pode atualizar o seu serviço em qualquer altura executando novamente o comando gcloud app deploy. Cada vez que implementa, é criada uma nova versão e o tráfego é encaminhado automaticamente para a versão mais recente.

Para confirmar que o serviço foi criado e que uma versão foi implementada:

1. Veja os seus serviços do App Engine na Google Cloud consola:

   Veja os serviços

   Deve ver um serviço listado com o nome default. O serviço predefinido é acessível publicamente no seguinte URL:

   https://PROJECT_ID.REGION_ID.r.appspot.com

2. Veja as suas versões:

   Ver versões

   Deve ver uma versão com indicação de data/hora, correspondente à sua implementação.

Para saber como enviar pedidos para serviços e versões específicos, consulte o artigo Como os pedidos são encaminhados.

Passos seguintes

Agora que tem um servidor Node.js em execução no App Engine, saiba como fazer atualizações ao seu serviço Web.