Configurar um projeto host (legado)

Console

1. No Google Cloud console, use o seletor de projetos para selecionar seu projeto.

2. Navegue até a página Visão geral do App Hub:

   Ir para Visão geral

3. Clique em Configurar o App Hub.

4. Na página Ativar o App Hub, escolha Configuração completa para criar um limite de vários projetos.

5. Anote o nome e o ID do projeto. Essas informações identificam o projeto host, e você vai usar esses valores para conceder acesso.

6. Analise a lista de APIs que estão sendo ativadas. Algumas APIs têm custos associados. Saiba mais sobre os custos das APIs ou clique em cada API para ver os custos associados.

7. Clique em Continuar.

8. Na guia Definir limite, verifique as informações do projeto.

9. Clique em add Adicionar projeto para adicionar projetos de serviço ao limite ou adicioná-los mais tarde.

10. Clique em Continuar.

11. Na guia Conceder acesso, escolha os papéis e permissões do IAM adequados para administradores no projeto. Para uma lista de papéis recomendados centrados em aplicativos em todos os Google Cloud produtos, consulte Conceder papéis centrados em aplicativos aos usuários.

12. Na caixa Novos principais , insira os usuários, grupos ou contas de serviço que precisam ter acesso de administrador a tarefas centradas em aplicativos no projeto.

13. Clique em Conceder papéis e em Concluir.

Mais tarde, é possível conceder outros papéis do IAM aos principais na página IAM. Para mais informações, consulte Conceder um papel do IAM usando o Google Cloud console.

gcloud

1. No Google Cloud console, ative o Cloud Shell.

   Ativar o Cloud Shell

   Na parte de baixo do Google Cloud console, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a Google Cloud CLI já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

2. Verifique se a versão mais recente da Google Cloud CLI está instalada:

   gcloud components update
   

3. Encontre o ID do projeto que você quer configurar como projeto host . Google Cloud

4. Defina o projeto host como o projeto padrão para comandos:

   gcloud config set project HOST_PROJECT_ID
   

   Substitua HOST_PROJECT_ID pelo ID do projeto que você quer configurar como projeto host.

5. Ative a API App Hub no projeto host:

   gcloud services enable apphub.googleapis.com \
       --project=HOST_PROJECT_ID
   

Console

1. No Google Cloud console, use o seletor de projetos para selecionar o projeto host.

   Acessar a página de boas-vindas

2. Navegue até a página Configurações de limite do App Hub:

   Acessar as configurações de limite

3. Clique em add Adicionar projeto.

4. Selecione os projetos de serviço que você quer anexar ao projeto host e adicionar ao limite de uma das seguintes maneiras:

   • Na lista de projetos, selecione as caixas de seleção dos projetos que você quer anexar como projetos de serviço.
   • Filtre os nomes dos projetos e selecione as caixas de seleção.

5. Clique em Selecionar.

   A tabela Projetos no limite mostra os projetos de serviço selecionados. O processo de anexação pode levar algum tempo para ser concluído.

6. Verifique se a lista de projetos de serviço está completa.

gcloud

1. Encontre o ID do projeto de cada um dos Google Cloud projetos que você quer configurar como projetos de serviço.

2. Anexe cada projeto de serviço:

   gcloud apphub service-projects add SERVICE_PROJECT_ID \
       --project=HOST_PROJECT_ID
   

   Substitua:

   • SERVICE_PROJECT_ID: o ID do projeto de serviço a ser anexado.
   • HOST_PROJECT_ID: o ID do projeto host.

3. Repita o processo anterior para cada projeto de serviço que você quer anexar ao projeto host.

Terraform

Para anexar um projeto de serviço a um projeto host usando o Terraform, use o recurso google_apphub_service_project_attachment, por exemplo:

resource "google_apphub_service_project_attachment" "example" {
    service_project_attachment_id = google_project.service_project.project_id
    depends_on = [time_sleep.wait_120s]
}

resource "google_project" "service_project" {
    project_id ="project-1"
    name = "Service Project"
    org_id = "123456789"
    deletion_policy = "DELETE"
}

resource "time_sleep" "wait_120s" {
    depends_on = [google_project.service_project]

    create_duration = "120s"
}

Console

1. No Google Cloud console, use o seletor de projetos para selecionar o projeto host.

   Acessar a página de boas-vindas

2. Navegue até a página IAM:

   Acessar IAM

3. Clique em person_add Conceder acesso. O painel Conceder acesso será aberto.

4. No campo Novos principais, insira o endereço de e-mail do principal a quem você quer conceder acesso ao App Hub.

5. Clique em Selecionar um papel e insira App Hub no campo Filtro.

6. Selecione o papel do IAM do App Hub que você pretende atribuir ao principal e clique em Salvar.

7. Em cada um dos projetos de serviço do App Hub anexados ao projeto host, repita o processo anterior para conceder os mesmos papéis aos mesmos usuários.

gcloud

1. Encontre o ID do projeto de cada um dos Google Cloud projetos que você configurou como projetos host e de serviço.

2. Conceda acesso aos principais no projeto host:

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
       --member='user:EMAIL_ADDRESS' \
       --role='ROLE_NAME'
   

   Substitua:

   • HOST_PROJECT_ID: o ID do projeto host.
   • EMAIL_ADDRESS: o endereço de e-mail do principal que precisa receber acesso ao App Hub no projeto host. Esse valor precisa ter o formato username@yourdomain, por exemplo, my.user@example.com.
   • ROLE_NAME: o papel do IAM do App Hub que você quer atribuir ao principal, por exemplo, roles/apphub.admin.

3. Em cada um dos projetos de serviço do App Hub anexados ao projeto host, conceda os mesmos papéis aos mesmos usuários:

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
       --member='user:EMAIL_ADDRESS' \
       --role='ROLE_NAME'
   

   Substitua SERVICE_PROJECT_ID pelo ID do projeto de serviço ao qual você está concedendo acesso.

Console

1. No Google Cloud console, use o seletor de projetos para selecionar o projeto host.

   Acessar a página de boas-vindas

2. Navegue até a página Configurações de limite do App Hub:

   Acessar as configurações de limite

3. Selecione as caixas de seleção dos projetos de serviço que você quer desanexar do projeto host e remover do limite.

4. Clique em Desanexar projetos.

   A tabela Projetos no limite é atualizada para mostrar apenas os projetos que permanecem anexados ao projeto host.

5. Verifique se a lista de projetos de serviço foi atualizada.

gcloud

1. Encontre o ID do projeto de cada um dos projetos de serviço que você quer remover do host project.

2. Remova cada projeto de serviço:

   gcloud apphub service-projects remove SERVICE_PROJECT_ID \
       --project=HOST_PROJECT_ID
   

   Substitua:

   • SERVICE_PROJECT_ID: o ID do projeto de serviço a ser removido.
   • HOST_PROJECT_ID: o ID do projeto host.

3. Repita o processo anterior para cada projeto de serviço que você quer remover do projeto host.