Como implantar serviços 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.

Esta seção do guia mostra como usar a CLI gcloud para implantar seu serviço da Web Java no App Engine. Para saber mais sobre o ambiente de execução do Java, consulte ambiente de execução do Java.

Antes de começar

  1. Crie um projeto do Google Cloud com um aplicativo do App Engine.
  2. Grave um servidor da Web Java pronto para implantar 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.

Como implantar o serviço

Na pasta my-java-service, onde o arquivo de compilação Maven POM ou Gradle está localizado, execute o seguinte comando no terminal:

gcloud app deploy

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

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

Como ver o 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

Parabéns! Você criou um aplicativo que pode armazenar e classificar imagens carregadas. Saiba como adicionar outros recursos ao aplicativo explorando as seguintes páginas: