Implantar o serviço da Web

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.

OK

Nesta seção do guia, explicamos como usar a CLI gcloud para implantar o serviço da Web do Node.js no App Engine. Para saber mais sobre o ambiente de execução do Node.js, consulte esta página.

Antes de começar

1. Crie um projeto do Google Cloud com um aplicativo do App Engine.
2. Grave um servidor da Web do Node.js pronto para implantações no App Engine.
3. Instale a Google Cloud CLI, que fornece a ferramenta de linha de comando gcloud. Verifique se gcloud está configurado para usar o projeto do Google Cloud em que você quer implantar.

Pontos principais

Use gcloud app deploy e gcloud app browse para implantar e visualizar seu serviço.

Implante seu serviço

Na pasta my-nodejs-service, onde o arquivo app.yaml está localizado, execute o seguinte comando no terminal:

gcloud app deploy

Seus arquivos de origem são enviados para o Google Cloud Storage. O Cloud Build cria seu aplicativo e o implanta no App Engine.

Para informações sobre outras maneiras de criar e implantar o aplicativo, consulte Como testar e implantar o aplicativo.

Observação: os arquivos listados no seu arquivo .gcloudignore não serão enviados.

Se você não tiver um, um arquivo .gcloudignore será criado para garantir que a pasta node_modules não seja enviada.

Os módulos do Node.js são instalados na nuvem, conforme listado nos seus arquivos package.json e package-lock.json. O serviço é iniciado usando o npm start.

Importante: para ter o melhor desempenho, o script start deve ser leve, porque é executado sempre que uma nova instância do aplicativo é criada.

Implantar vários serviços

É possível adicionar vários serviços no seu projeto criando um arquivo app.yaml para cada um deles. Inclua o atributo service em cada arquivo app.yaml para especificar o nome do serviço. Para saber mais sobre como estruturar o aplicativo usando vários serviços, consulte Como estruturar serviços da Web no App Engine.

Para implantar vários serviços, siga estas instruções. Cada serviço implantado terá o próprio URL atribuído.

Ver seu serviço

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

gcloud app browse

Serviços e versões

Você acabou de criar e implantar um serviço no App Engine. Você pode especificar o nome do serviço no arquivo app.yaml. Se o nome for omitido, ele será tratado como default. O primeiro serviço que você implanta precisa ser o padrão.

Você pode atualizar seu serviço a qualquer momento executando o comando gcloud app deploy novamente. A cada implantação, uma nova versão é criada e o tráfego é roteado automaticamente para a versão mais recente.

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

1. Veja os serviços do App Engine no console do Google Cloud:

   Ver os serviços

   Você verá um serviço listado, chamado default. Ele é acessível publicamente no seguinte URL:

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

2. Veja as versões:

   Ver as versões

   Você verá uma versão com carimbo de data/hora, correspondente à implantação.

Para saber como enviar solicitações para serviços e versões específicos, consulte Como as solicitações são encaminhadas.

Próximas etapas

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