Criar seu projeto

Observação: se você estiver implantando um novo serviço da Web em Python no Google Cloud, recomendamos começar com o Cloud Run.

Para implantar o app no App Engine, você precisa criar um Google Cloud projeto e os recursos do aplicativo do App Engine.

O projeto Google Cloud é um contêiner de nível superior que contém seu aplicativo do App Engine e outros recursos do Google Cloud .

O aplicativo do App Engine é um recurso que você precisa criar para ativar o App Engine. O recurso de aplicativo do Google App Engine define a região em que você quer executar seu serviço da Web e armazenar as respectivas configurações, credenciais e metadados relacionados. Somente um único recurso de aplicativo do App Engine pode ser criado por cada projeto do Google Cloud . Não é possível alterar a região especificada depois que esses recursos forem criados.

Se você já tem um projeto do Google Cloud com o App Engine e a API Cloud Build ativada, veja Como gravar um serviço da Web.

Criar um projeto Google Cloud

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Para inicializar a gcloud CLI, execute o seguinte comando:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Para inicializar a gcloud CLI, execute o seguinte comando:

gcloud init

1. Execute o comando gcloud a seguir para ativar o App Engine e criar os recursos de aplicativo associados. Observe que não é possível alterar o local selecionado posteriormente.

   gcloud app create

2. Devido a mudanças no comportamento padrão de como o Cloud Build usa contas de serviço em novos projetos e mudanças na política da organização "seguro por padrão", talvez seja necessário conceder outros papéis à conta de serviço de implantação. Para mais informações sobre como conceder papéis específicos, consulte o guia de solução de problemas.

Locais do App Engine

O App Engine é regional. Isso significa que a infraestrutura que executa os aplicativos está em uma determinada região que é gerenciada pelo Google para estar disponível de modo redundante em todas as zonas dessa região.

Atender aos requisitos de latência, disponibilidade ou durabilidade são os principais fatores para selecionar a região de execução dos aplicativos. Geralmente, é possível selecionar a região mais próxima dos usuários do aplicativo, mas considere os locais em que o App Engine está disponível, bem como os locais dos outros produtos e serviços doGoogle Cloud usados pelo app. O uso de serviços em vários locais pode afetar a latência e o preço do aplicativo.

Não é possível alterar a região de um aplicativo depois de defini-la.

Observação: dois locais, chamados europe-west e us-central nos comandos do App Engine e no console Google Cloud , são chamados europe-west1 e us-central1, respectivamente, em todos os outros lugares da documentação do Google.

Se você já criou um aplicativo do App Engine, será possível ver a região dele com um dos seguintes procedimentos:

• Execute o comando gcloud app describe.

• Abra o Painel do App Engine no console Google Cloud . A região aparece perto do topo da página.

OK

Próximas etapas

Agora que seu projeto do Google Cloud está configurado, você está pronto para escrever um serviço da Web básico.