Documentação do Oracle Cloud Infrastructure

Criando uma Conexão Externa

Crie uma conexão com repositórios externos, como GitHub, GitLab, Bitbucket Cloud, Visual Builder Studio, Bitbucket Server e GitLab Server.

Dependendo do repositório ao qual deseja se conectar, antes de criar a conexão, faça o seguinte:

  • GitHub Enterprise Cloud, GitLab SaaS, GitLab Server e Visual Builder Studio: Você precisa recuperar um PAT (token de acesso pessoal) desses provedores e armazenar seu PAT com segurança em um vault do OCI. Para obter instruções, consulte Integração de Origem do Build.
  • Bitbucket Cloud: Você precisa do seu nome de usuário do Bitbucket e criar uma senha de aplicativo; em seguida, armazenar a senha de aplicativo em um vault do OCI. Consulte Gerando uma Senha de Aplicativo para o Bitbucket Cloud.
  • Bitbucket Server: Crie o toque de acesso HTTP e, em seguida, armazene o token de acesso em um vault do OCI.

Cada serviço do OCI é integrado com o serviço IAM (Identity and Access Management) para autenticação e autorização. Para criar grupos dinâmicos e políticas para repositórios de código e conexões externas, consulte Políticas de Repositório de Código. Para obter mais detalhes, consulte Políticas do Serviço IAM do DevOps.

Para acessar DevOps usando a Console, a API REST e a CLI do Oracle Cloud, consulte Acessando DevOps.

    1. Abra o menu de navegação e clique em Serviços ao Desenvolvedor. No DevOps, clique em Projetos.
    2. Selecione um projeto e, no menu esquerdo, clique em Conexões Externas.
    3. Clique em Criar Conexão Externa.
    4. No painel Criar conexão externa, forneça as seguintes informações:
      • Informe um nome e uma descrição para a conexão. É opcional inserir uma descrição.
      • Selecione um tipo de conexão externa.

        Se você selecionar Bitbucket Cloud, informe seu Nome de Usuário do Bitbucket.

      • Se você selecionar o Bitbucket Server ou o GitLab Server, informe o URL Base do Bitbucket Server hospedado ou do GitLab Server. Para o serviço VBS (Visual Builder Studio), informe o URL da instância do VBS.
      • Selecione o valor do vault e do segredo que contém o PAT (token de acesso pessoal) para estabelecer conexão com GitHub, GitLab ou serviço Visual Builder Studio.

        Se você selecionar Bitbucket Cloud, selecione o valor do vault e o segredo da senha do aplicativo.

      • (Opcional) Para configuração de verificação de TLS, selecione um pacote de CAs para autenticar o servidor do Bitbucket ou do GitLab hospedado automaticamente.

        Isso não será aplicável se o servidor de repositório (GitLab Server ou Bitbucket Server) for hospedado com a autoridade de certificação publicamente confiável.

      • (Opcional) Para adicionar tags à conexão, clique em Mostrar opções de tag.

        Tag é um sistema de metadados que permite organizar e rastrear os recursos de sua tenancy.

        Se você tiver permissões para criar um recurso, também terá permissões para adicionar a ele tags de formato livre.

        Para adicionar uma tag definida, você deverá ter permissões para usar o namespace de tag.

        Para obter mais informações, consulte Tags de Recursos

    5. Clique em Criar.
      A conexão com o repositório externo selecionado foi criada com sucesso.
    Agora você pode espelhar um repositório de código de GitHub, GitLab, Bitbucket Cloud ou do serviço Visual Builder Studio. Consulte Espelhando um Repositório.

  • Para criar uma conexão GitHub, execute o comando create-github-connection:

    oci devops connection create-github-connection --personal-access-token, --project-id

    Para criar uma conexão GitLab, execute o comando create-gitlab-connection:

    oci devops connection create-gitlab-connection --personal-access-token, --project-id

    Para criar uma conexão do Bitbucket Cloud, execute o comando create-bitbucket-cloud-connection:

    oci devops connection create-bitbucket-cloud-connection --bitbucket-cloud-username, --app-password, --project-id

    Para criar uma conexão do serviço Visual Builder Studio, execute o comando create-vbs-connection:

    oci devops connection create-vbs-connection --access-token, --base-url, --project-id

    Para criar uma conexão do Bitbucket Server, execute o comando create-bitbucket-server-connection:

    oci devops connection create-bitbucket-server-connection --personal-access-token, --base-url, --project-id

    Para criar uma conexão do GitLab Server, execute o comando create-gitlab-server-connection:

    oci devops connection create-gitlab-server-connection --personal-access-token, --base-url, --project-id

    Para exibir a lista de conexões, execute o comando list:

    oci devops connection list

    Para obter todos os comandos de connection:

    oci devops connection -h

  • Para criar uma conexão externa, use a operação CreateConnection.