Criar seu projeto

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

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

O aplicativo do App Engine é um recurso que você precisa criar para ativar o App Engine. O recurso de aplicativo do 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 Google Cloud projeto. Não é possível alterar a região especificada depois que esses recursos forem criados.

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

Crie um Google Cloud projeto do .

  1. Faça login nasua Google Cloud conta. Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.
  2. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

  5. Instale a Google Cloud CLI.

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

  7. Para inicializar a CLI gcloud, execute o seguinte comando:

    gcloud init
  8. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

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

  11. Instale a Google Cloud CLI.

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

  13. Para inicializar a CLI gcloud, execute o seguinte comando:

    gcloud init
  14. 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
  15. Devido a mudanças no comportamento padrão de como o Cloud Build usa contas de serviço em novos projetos e mudanças nas políticas da organização seguras por padrão, talvez seja necessário conceder papéis adicionais à sua 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 Google Cloud produtos e serviços 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.

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

Próximas etapas

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