Implemente o seu serviço Web

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.

Use a Google Cloud CLI para implementar o seu serviço Web no App Engine.

Embora esta versão inicial do serviço Web não tenha o Firestore no modo Datastore (Datastore) nem a autenticação do Firebase, pode implementá-la no App Engine nesta fase para testar e garantir que funciona conforme esperado.

Antes de começar

Se tiver concluído todos os passos anteriores neste guia, ignore esta secção. Caso contrário, conclua uma das seguintes opções:

  • Comece por Criar uma app Python 3 e conclua todos os passos anteriores a este.

  • Se já tiver um Google Cloud projeto, pode continuar transferindo uma cópia do serviço Web:

    1. Transfira o repositório da aplicação de exemplo através do Git:

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

      Em alternativa, pode transferir o exemplo como um ficheiro ZIP e, de seguida, extraí-lo.

    2. Navegue para o diretório que contém uma cópia dos ficheiros do passo anterior:

      cd python-docs-samples/appengine/standard_python3/building-an-app/building-an-app-1
      

Implemente o seu serviço

Para implementar o seu serviço Web, execute o comando gcloud app deploy a partir do diretório raiz do seu projeto, onde se encontra o ficheiro app.yaml:

gcloud app deploy

Sempre que implementa o seu serviço Web, é criada uma nova versão dessa app no App Engine. Durante a implementação, é criada uma imagem de contentor através do serviço Cloud Build e, em seguida, é carregada uma cópia para o Google Cloud Storage antes de ser executada no App Engine.

Para mais informações sobre a implementação no App Engine, consulte o artigo Testar e implementar a sua app.

Ver 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, introduza o seguinte comando:

gcloud app browse

Gerir serviços e versões

Acabou de implementar uma versão do serviço Web no App Engine. Sempre que implementa uma versão do seu código, essa versão é criada num serviço. A implementação inicial no App Engine tem de ser criada no serviço default, mas, para implementações subsequentes, pode especificar o nome do seu serviço no ficheiro app.yaml.

Pode atualizar um serviço em qualquer altura executando o comando gcloud app deploy e implementando novas versões nesse serviço. Sempre que atualiza um serviço, o tráfego é encaminhado automaticamente para a versão implementada mais recentemente. No entanto, pode incluir flags gcloud para alterar o comportamento do comando de implementação.

Use a Google Cloud consola para gerir e ver os serviços e as versões que implementa no App Engine:

Para mais informações sobre o padrão de design de vários serviços, consulte o artigo Uma vista geral do App Engine. Para saber como enviar pedidos a serviços e versões específicos, consulte o artigo Dividir tráfego.

Passos seguintes

Agora que tem um serviço Python em execução no App Engine, está pronto para saber como processar dados com o Datastore.