Crie um repositório

Esta página descreve como criar um repositório através da interface Web do Secure Source Manager ou da API Secure Source Manager.

Se a sua instância do Secure Source Manager ainda não tiver sido criada, consulte o artigo Crie uma instância do Secure Source Manager para começar.

Antes de começar

  1. Crie ou peça acesso a uma instância do Secure Source Manager. Para mais informações, consulte Crie uma instância do Gestor de origens seguras.

  2. Install the Google Cloud CLI.

  3. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  4. To initialize the gcloud CLI, run the following command: 

    gcloud init
  5. Instale o componente da betaCLI do Google Cloud: 
    gcloud components install alpha

Funções necessárias

Para receber as autorizações de que precisa para criar um repositório, peça ao seu administrador que lhe conceda as seguintes funções do IAM:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Para obter informações sobre a concessão de funções do Secure Source Manager, consulte os artigos Controlo de acesso com o IAM e Conceda aos utilizadores acesso à instância.

Crie um repositório

Interface Web

  1. Para aceder à instância do Secure Source Manager através da respetiva interface Web, copie o seguinte URL para a barra de endereço do navegador.

    INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

    Substitua o seguinte:

    • INSTANCE_ID com o nome da instância.
    • PROJECT_NUMBER com o número do projeto Google Cloud da instância. Para obter informações sobre a identificação de projetos, consulte o artigo Identificar projetos.
    • LOCATION com a região da instância.

  2. Se necessário, faça a autenticação com as suas credenciais do Secure Source Manager.

  3. Clique no ícone + Criar novo repositório na parte superior direita do menu de navegação.

  4. Preencha os detalhes do repositório:

    1. ID do repositório: introduza um nome para o repositório.

    2. Descrição: opcional. Descrição do repositório.

    3. Agência predefinida: nome da agência predefinida.

    4. Inicializar repositório: opcional. Selecione esta opção se quiser inicializar o repositório e adicionar ficheiros .gitignore, license e README.

    5. .gitignore: opcional. Escolha os ficheiros que não quer monitorizar através dos modelos do menu pendente.

    6. license: opcional. Selecione uma licença comum no menu pendente.

  5. Clique em Criar repositório.

gcloud

  1. Crie um repositório através da CLI gcloud executando o seguinte comando:

    gcloud source-manager repos create REPOSITORY_ID \
    --region=LOCATION \
    --project=PROJECT_ID \
    --instance=INSTANCE_ID \
    --description=DESCRIPTION \
    --default-branch=BRANCH \
    --gitignores=GITIGNORES \
    --license=LICENSE \
    --readme=README

    Substitua o seguinte:

    • REPOSITORY_ID com o nome do seu repositório.

    • LOCATION com a região onde quer criar o repositório. Para ver informações sobre as localizações suportadas, consulte a secção Localizações.

    • PROJECT_ID com o ID do projeto da instância do Secure Source Manager na qual quer criar o repositório.

    • INSTANCE_ID com o ID da instância da instância na qual está a criar o repositório. Para listar as instâncias do Secure Source Manager no seu projeto, consulte o artigo Liste e veja instâncias.

    • DESCRIPTION com uma descrição do repositório. Esta ação é opcional e pode ser omitida.

    • BRANCH com o nome do ramo predefinido. Isto é opcional e pode ser omitido. O nome do ramo predefinido quando não está definido é main.

    • GITIGNORES com uma lista separada por vírgulas de nomes de modelos .gitignore. Esta ação é opcional e pode ser omitida. Para ver a lista completa de modelos disponíveis, consulte a referência de configuração de inicialização do repositório.

    • LICENSE com o nome do modelo de licença a aplicar ao seu repositório. Esta ação é opcional e pode ser omitida. Para ver a lista completa de modelos de licenças disponíveis, consulte a referência de configuração de inicialização do repositório.

    • README com default para criar um ficheiro README a partir do modelo predefinido. Esta ação é opcional e pode ser omitida. Se for omitido, não é criado um ficheiro README.