Aviso: nos próximos meses, vamos reorganizar o site de documentação do App Engine para facilitar a localização de conteúdo e o alinhamento com o restante dos produtos do Google Cloud. O mesmo conteúdo estará disponível, mas a navegação agora corresponderá ao restante dos produtos do Cloud.

O Python 3.10 já está disponível para todos os usuários.

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.

Use a Google Cloud CLI para implantar o serviço da Web no App Engine.

Embora essa versão inicial do serviço da Web não tenha o Firestore no modo Datastore (Datastore) ou a autenticação do Firebase, é possível implantá-la no App Engine neste estágio para testar e garantir que ela funcione como esperado.

Antes de começar

Se você concluiu todas as etapas anteriores deste guia, pule esta seção. Caso contrário, conclua um dos procedimentos abaixo:

  • Comece por Como criar um aplicativo Python 3 e conclua todas as etapas anteriores a esta.

  • Se você já tiver um projeto do Cloud, continue fazendo o download de uma cópia do serviço da Web:

    1. Faça o download do repositório do aplicativo de amostra usando Git:

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

      Outra alternativa é fazer o download da amostra como um arquivo ZIP e extraí-lo.

    2. Navegue até o diretório que contém uma cópia dos arquivos da etapa anterior:

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

Como implantar o serviço

Para implantar o serviço da Web, execute o comando gcloud app deploy no diretório raiz do projeto, em que o arquivo app.yaml está localizado:

gcloud app deploy

Sempre que você implanta um serviço da Web, uma nova versão (link em inglês) desse aplicativo é criada no App Engine. Durante a implantação, uma imagem de contêiner é criada usando o serviço Cloud Build. Em seguida, uma cópia é enviada ao Google Cloud Storage antes de ser executada no App Engine.

Para mais informações sobre como implantar no App Engine, consulte Como testar e implantar o aplicativo.

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

gcloud app browse

Como gerenciar serviços e versões

Você acaba de implantar uma versão do serviço da Web no App Engine. Cada vez que você implanta uma versão do seu código, essa versão é criada em um serviço. A implantação inicial no App Engine precisa ser criada no serviço default, mas, para implantações subsequentes, é possível especificar o nome do serviço no arquivo app.yaml.

Você pode atualizar um serviço a qualquer momento executando o comando gcloud app deploy e implantando novas versões para esse serviço. Sempre que você atualiza um serviço, o tráfego é roteado automaticamente para a versão implantada mais recentemente. No entanto, é possível incluir sinalizações gcloud para alterar o comportamento do comando de implantação.

Use o console para gerenciar e visualizar os serviços e as versões que você implanta no App Engine:

Para ver mais informações sobre o padrão de design de vários serviços, consulte Visão geral do App Engine. Para saber como enviar solicitações para serviços e versões específicos, consulte Como dividir o tráfego.

Próximas etapas

Agora que você tem um serviço do Python 3 em execução no App Engine, já pode aprender a gerenciar dados com o Datastore.