Criar projetos

Os projetos são a unidade operacional fundamental na hierarquia de recursos do Cloud de Confiance by S3NS e permitem organizar, isolar e controlar os recursos da nuvem. Entre as pastas (ou o recurso da organização) e os recursos de serviço, como máquinas virtuais e armazenamento, os projetos ajudam a gerenciar APIs, faturamento e permissões em todos os ambientes. Para criar e gerenciar projetos, use o console do Cloud de Confiance , a Google Cloud CLI ou a API Cloud Resource Manager.

Principais características dos projetos

As principais características dos projetos incluem:

  • O contêiner de serviço principal: um projeto é o nível básico em que você ativa os serviços do Cloud de Confiance (APIs) e cria recursos, como instâncias do Compute Engine ou conjuntos de dados do BigQuery.

  • O limite de confiança: os projetos servem como uma camada de isolamento. Por padrão, os recursos de um projeto não têm acesso aos recursos de outro, o que ajuda a estabelecer um perímetro seguro para diferentes aplicativos ou ambientes.

  • A unidade de faturamento: os projetos são a principal maneira de rastrear, organizar e separar os custos em toda a organização.

  • O ponto de anexo da política: embora os projetos herdem políticas de pastas e do recurso da organização, o nível do projeto é o local mais comum em que você concede permissões específicas do Identity and Access Management (IAM) a desenvolvedores e contas de serviço para tarefas diárias.

Antes de começar

Leia sobre o recurso do projeto na visão geral da hierarquia de recursos. Para orientações sobre como configurar sua hierarquia de recursos, consulte Decidir uma hierarquia de recursos para sua zona de destino do Cloud de Confiance .

Os seguintes identificadores são usados no projeto:

  • Nome do projeto: um nome legível por humanos para o projeto.

    O nome do projeto tem os seguintes requisitos:

    • Ele precisa ter entre 4 e 30 caracteres.
    • Ele pode conter letras, números, aspas simples, hifens, espaços ou pontos de exclamação.
    • Ele precisa terminar com uma letra ou um dígito.

    O nome do projeto não é usado por nenhuma API do Google Você pode editar o nome do projeto a qualquer momento durante ou após a criação do projeto. Os nomes dos projetos não precisam ser exclusivos.

  • ID do projeto: um identificador exclusivo personalizável para seu projeto.

    O ID do projeto é uma string exclusiva que diferencia seu projeto de todos os outros no Cloud de Confiance by S3NS. Depois que você insere um nome de projeto, o Cloud de Confiance console gera um ID do projeto exclusivo que pode ser uma combinação de letras, números e hifens. Use o ID do projeto gerado, mas é possível editá-lo durante a criação do projeto. Depois da criação do projeto, o ID do projeto é permanente.

    Um ID do projeto tem os seguintes requisitos:

    • Ele precisa ter entre 6 e 30 caracteres.
    • Ele pode conter apenas letras minúsculas, números e hifens.
    • Precisa começar com uma letra.
    • Não pode terminar com um hífen.
    • Ele não pode estar em uso ou ter sido usado anteriormente, incluindo projetos excluídos.
    • Ele não pode conter strings restritas, como google e ssl. Evite usar strings como undefined e null em um ID do projeto.

    Todos Cloud de Confiance os IDs de projeto recebem automaticamente o prefixo s3ns:.

  • Número do projeto: um identificador exclusivo gerado automaticamente para seu projeto. Para encontrar o número do projeto, consulte Identificar projetos.

Não inclua informações sensíveis, como informações de identificação pessoal ou dados de segurança, no nome do projeto, no ID do projeto ou em outros nomes de recursos. O ID do projeto aparece no nome de muitos outros recursos do Cloud de Confiance by S3NS. Fazer referência ao projeto ou aos recursos dele expõe o ID do projeto e o nome do recurso.

Crie um projeto

Para criar um projeto, você deve ter a permissão resourcemanager.projects.create. Essa permissão está incluída em papéis como o de criador de projetos (roles/resourcemanager.projectCreator).

Para saber como conceder o papel a indivíduos e limitar o acesso a todos os recursos da organização, consulte a página Como gerenciar papéis padrão da organização.

Se você não especificar o recurso pai, um será selecionado automaticamente, se aplicável, com base no domínio da conta de usuário.

É possível criar um novo projeto usando o console do Cloud de Confiance , a Google Cloud CLI ou o método projects.create().

Console

Para criar um projeto novo, execute as seguintes etapas:

  1. Acesse a página Gerenciar recursos no console do Cloud de Confiance .

    Acessar "Gerenciar recursos"

    As etapas restantes aparecem no console do Cloud de Confiance .

  2. Clique em Criar projeto.
  3. Na janela Novo projeto que vai ser exibida, insira o nome do projeto e selecione uma conta de faturamento, conforme aplicável. O nome de um projeto só pode ser composto por letras, números, aspas simples, hifens, espaços ou pontos de exclamação e precisa ter entre 4 e 30 caracteres.
  4. Insira o recurso da organização ou pasta mãe na caixa Recurso mãe. Esse recurso vai ser o pai hierárquico do novo projeto.
  5. Ao concluir a inserção dos detalhes do novo projeto, clique em Criar.

gcloud

  1. No console do Cloud de Confiance , ative o Cloud Shell.

    Ativar o Cloud Shell

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

  2. Para criar um novo projeto, use o comando gcloud projects create:

    gcloud projects create PROJECT_ID
    

    Em que PROJECT_ID é o código do projeto que você quer criar. Um ID do projeto precisa começar com uma letra minúscula e deve conter apenas letras ASCII, dígitos e hifens e deve ter entre 6 e 30 caracteres.

    Para criar um projeto com um recurso de organização ou uma pasta como pai, use as flags --organization ou --folder. Como um recurso pode ter apenas um pai, só uma dessas sinalizações pode ser usada:

    gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID
    
    gcloud projects create PROJECT_ID --folder=FOLDER_ID
    

REST

Não é possível usar determinadas palavras no ID do projeto quando cria um novo projeto com o método projects.create(). Alguns exemplos incluem google, null, undefined e ssl. Quando você usa uma palavra restrita, a solicitação retorna com um erro INVALID_ARGUMENT.

A solicitação a seguir cria apenas um projeto e não o associa automaticamente a uma conta de faturamento. Use o método projects.updateBillingInfo para definir ou atualizar a conta de faturamento associada a um projeto.

Criar solicitação de projeto:

POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json

{
    "projectId": "our-project-123",
    "name": "my project",
    "labels": {
      "mylabel": "prod"
    }
}

Criar resposta de projeto:

{
    "name": "operations/pc.123456789",
}

Receber solicitação de operação:

GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json

Receber resposta de operação:

{
    "name": "operations/pc.123456789",
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloudresourcemanager.v3.Project",
        "projectNumber": "464036093014",
        "projectId": "our-project-123",
        "lifecycleState": "ACTIVE",
        "name": "my project",
        "labels": {
        "mylabel": "prod"
        },
    "createTime": "2016-01-07T21:59:43.314Z"
    }
}

Adicionar tags durante a criação do projeto

As tags fornecem uma maneira de criar anotações para recursos. É possível adicionar tags ao criar projetos. É necessário atribuir o papel Usuário de tag ao adicionar tags. Para mais informações sobre as permissões atribuídas a esse papel, consulte Gerenciar tags em recursos. Só é possível adicionar o namespace para os pares de chave-valor da tag de uma das seguintes maneiras:

gcloud

Para adicionar tags durante a criação do projeto, execute o seguinte comando:

gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS

Substitua:

  • PROJECT_ID é o identificador exclusivo do projeto.
  • ORGANIZATION_ID é o identificador exclusivo da organização.
  • KEY_VALUE_PAIRS é uma lista separada por vírgulas de pares de chave-valor que podem ser atribuídos ao recurso. Um exemplo de pares de chave-valor separados por vírgulas é 123/environment=production, 456/create=testresource. Neste exemplo, 123 e 456 são os identificadores exclusivos (IDs) dos recursos da organização ou da pasta em que as chaves de tag são definidas.

REST

O snippet a seguir é uma solicitação JSON em que você cria um projeto e adiciona tags a ele.

  POST https://cloudresourcemanager.googleapis.com/v3/projects/
  Authorization: *************
  Content-Type: application/json

  {
    "projectId": "our-project-456",
    "name": "my project",
    "parent": "organizations/123",
    "tags": {
      "key": "123/environment"
      "value": "production"
    },
"tags": {
      "key": "123/costCenter"
      "value": "marketing"
  }
}

Designar ambientes de projeto com tags

É possível usar tags para distinguir visualmente os projetos com base no ambiente, como produção, preparo ou desenvolvimento. Isso ajuda a evitar erros e melhora a conscientização ao trabalhar em ambientes sensíveis. O Google adiciona um indicador visual ao projeto no seletor de projetos do console do Cloud de Confiance quando um projeto com um par de chave-valor de tag específico é selecionado. Esse indicador lembra que qualquer mudança pode afetar os aplicativos de produção ou não produção associados. As tags podem ser herdadas pelo projeto ou definidas diretamente nele.

Para usar esse recurso, faça o seguinte:

  1. Crie uma chave de tag chamada environment.
  2. Crie valores de tag para as categorias de ambiente que você usa. Os valores a seguir são aceitos e mapeados para um selo correspondente no seletor de projetos do console:
    • Produção: Prod, prod, Production, production
    • Desenvolvedor: Dev, dev, Development, development
    • Teste: Test, test, Testing, testing, QA, qa, Quality assurance, quality assurance
    • Staging: Staging, staging, Stage, stage
  3. Anexe a tag apropriada ao projeto criando uma vinculação de tag.

Se um projeto tiver várias tags de ambiente (por exemplo, uma herdada de uma pasta e outra diretamente no projeto), a tag mais específica será usada para determinar o selo.

Como criar um projeto usando uma conta de serviço

Você pode usar uma conta de serviço para automatizar a criação do projeto. Assim como as contas de usuário, as contas de serviço podem receber permissão para criar projetos em um recurso de organização. As contas de serviço não podem criar projetos fora de um recurso de organização e precisam especificar o recurso pai ao criar um projeto. As contas de serviço podem criar um novo projeto usando a CLI gcloud ou o método projects.create().

Como gerenciar cotas de projeto

Para solicitar mais capacidade para projetos na cota da sua organização, abra um tíquete de suporte com a equipe do Cloud de Confiance by S3NS . Para mais detalhes, consulte Solicitar um ajuste de cota.

A seguir