Criar um projeto

Neste documento, explicamos como criar um projeto do Google Distributed Cloud (GDC) com isolamento físico para agrupar seus recursos em uma organização. Os projetos fornecem um ciclo de vida e um limite de política para os recursos, permitindo que vários grupos de usuários gerenciem os recursos do GDC separadamente.

Este documento é destinado a públicos-alvo como administradores de TI, engenheiros de segurança e administradores da rede no grupo de administradores de plataforma que são responsáveis por gerenciar recursos na organização. Para mais informações, consulte Públicos-alvo da documentação do GDC com isolamento físico.

Antes de começar

Para executar as tarefas neste documento, você precisa fazer o seguinte:

  • Para receber as permissões necessárias para criar um projeto, peça ao administrador da organização do IAM para conceder a você o papel de Criador de projetos (project-creator).

  • Para usar a CLI gdcloud, verifique se ela está instalada. Para mais informações, consulte Instalar a CLI gdcloud.

  • Para usar o Terraform, verifique se ele está configurado. Para mais informações, consulte Configurar o Terraform.

Crie um novo projeto

É possível criar um projeto para fornecer um agrupamento lógico de recursos de serviço. Por exemplo, é possível criar projetos separados para armazenar recursos para ambientes de desenvolvimento, teste e produção.

Para receber as permissões necessárias para criar um projeto, peça ao admin. da organização do IAM para conceder a você o papel de Criador de projetos. Para mais informações sobre como conceder permissões, consulte a seção Atribuir uma vinculação de papel à identidade de serviço.

Console

Para criar um novo projeto usando o console do GDC, siga estas etapas:

  1. No menu de navegação, clique em Projetos.
  2. Clique em Adicionar projeto.
  3. No campo Nome do projeto, digite um nome.
  4. Especifique o ID da conta de faturamento que será associada ao projeto. Para rastrear os custos de recursos do projeto, ele precisa estar vinculado a uma conta de faturamento. Para mais informações, consulte Criar e vincular contas de faturamento.
  5. Clique em Continuar.
  6. Opcional: configure os recursos de rede do projeto. Desmarque a caixa de seleção Ativar proteção contra exfiltração de dados para desativar todo o tráfego de saída para outros projetos na organização.
  7. Clique em Continuar.
  8. Na seção Revisar, leia o resumo e clique em Criar.
  9. Para verificar se o novo projeto está disponível, uma mensagem é exibida no console: Project PROJECT_NAME successfully created.

gdcloud

Para criar um projeto usando a CLI gdcloud, siga estas etapas:

  1. Para criar um projeto, execute:

    gdcloud projects create PROJECT_ID

    Substitua PROJECT_ID pelo identificador exclusivo do novo projeto.

  2. Verifique se o novo projeto está disponível:

    gdcloud projects list

    O resultado será o seguinte:

    METADATA.NAME
my-project

  3. Vincule seu novo projeto a uma conta de faturamento. Para acompanhar os custos de recursos do projeto, é necessário ter uma conta de faturamento associada vinculada ao projeto.

API

Para criar um projeto usando a API diretamente, siga estas etapas:

  1. Defina uma variável de ambiente para o servidor de API de gerenciamento global do arquivo kubeconfig:

    export KUBECONFIG=GLOBAL_API_SERVER_KUBECONFIG

    Se você não tiver o arquivo kubeconfig do servidor de API de gerenciamento global, gere um.

  2. Crie e aplique o recurso personalizado Project:

    kubectl --kubeconfig=${KUBECONFIG} apply -f - <<EOF
apiVersion: resourcemanager.global.gdc.goog/v1
kind: Project
metadata:
  namespace: platform
  name: PROJECT_ID
EOF

    Substitua PROJECT_ID pelo identificador exclusivo do novo projeto.

  3. Verifique se o novo projeto está disponível:

    kubectl --kubeconfig=${KUBECONFIG} get projects -n platform

    O resultado será o seguinte:

    NAME           READY
my-project

  4. Vincule seu novo projeto a uma conta de faturamento. Para acompanhar os custos de recursos do projeto, é necessário ter uma conta de faturamento associada vinculada ao projeto.

Terraform

Para criar um projeto usando o Terraform, siga estas etapas:

  1. Verifique se o Terraform está configurado e se os conjuntos de permissões adequados estão definidos. Para mais informações, consulte a página Configurar o Terraform.

  2. Em um arquivo de configuração do Terraform, insira o seguinte snippet de código:

    provider "kubernetes" {
  config_path = "GLOBAL_API_SERVER_KUBECONFIG"
}

    Substitua GLOBAL_API_SERVER_KUBECONFIG pelo caminho para o arquivo kubeconfig do servidor de API de gerenciamento global. Se você não tiver esse arquivo kubeconfig, gere um.

  3. Em um arquivo de configuração do Terraform, como main.tf, insira o seguinte snippet de código:

    resource "kubernetes_manifest" "project-create" {
  manifest = {
    "apiVersion" = "resourcemanager.global.gdc.goog/v1"
    "kind" = "Project"
    "metadata" = {
      "name" = "PROJECT_ID"
      "namespace" = "platform"
    }
  }
}

    Substitua PROJECT_ID pelo identificador exclusivo do novo projeto.

  4. Aplique o novo projeto usando o Terraform:

    terraform apply

  5. Vincule seu novo projeto a uma conta de faturamento. Para acompanhar os custos de recursos do projeto, é necessário ter uma conta de faturamento associada vinculada ao projeto.