Oracle Cloud Infrastructure-Dokumentation

Externe Verbindung erstellen

Erstellen Sie eine Verbindung zu externen Repositorys wie GitHub, GitLab, Bitbucket Cloud, Visual Builder Studio, Bitbucket Server und GitLab Server.

Bevor Sie die Verbindung erstellen, müssen Sie abhängig vom Repository, zu dem Sie eine Verbindung herstellen möchten, folgende Schritte ausführen:

  • GitHub Enterprise Cloud, GitLab SaaS, GitLab Server und Visual Builder Studio: Sie müssen ein persönliches Zugriffstoken (Personal Access Token, PAT) von diesen Anbietern abrufen und das PAT sicher in einem OCI-Vault speichern. Anweisungen finden Sie unter Build-Quellenintegration.
  • Bitbucket Cloud: Sie benötigen Ihren Bitbucket-Benutzernamen, um ein App-Kennwort zu erstellen, das Sie dann in einem OCI-Vault speichern. Weitere Informationen finden Sie unter App-Kennwort für Bitbucket Cloud generieren.
  • Bitbucket Server: Erstellen Sie ein HTTP-Zugriffstoken, und speichern Sie es in einem OCI-vault.

Jeder Service in OCI kann zur Authentifizierung und Autorisierung in Identity and Access Management (IAM) integriert werden. Informationen zum Erstellen dynamischer Gruppen und Policys für Code-Repositorys und externe Verbindungen finden Sie unter Code-Repository-Policys. Weitere Informationen finden Sie unter DevOps-IAM-Policys.

Informationen zum Zugriff auf DevOps über die Oracle Cloud-Konsole, die REST-API und die CLI finden Sie unter Auf DevOps zugreifen.

    1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter DevOps auf Projekte.
    2. Wählen Sie ein Projekt aus, und klicken Sie im linken Menü auf Externe Verbindungen.
    3. Klicken Sie auf Externe Verbindung erstellen.
    4. Geben Sie im Bereich Externe Verbindung erstellen die folgenden Informationen an:
      • Geben Sie einen Namen und eine Beschreibung für die Verbindung ein. Sie können eine Beschreibung eingeben.
      • Wählen Sie einen externen Verbindungstyp aus.

        Wenn Sie Bitbucket Cloud auswählen, geben Sie Ihren Bitbucket-Benutzernamen ein.

      • Wenn Sie Bitbucket Server oder GitLab Server auswählen, geben Sie die Basis-URL des gehosteten Bitbucket Server oder den GitLab Server ein. Geben Sie für Visual Builder Studio (VBS) die URL der VBS-Instanz ein.
      • Wählen Sie den Vault und den Secret-Wert aus, der das persönliche Zugriffstoken (PAT) enthält, um eine Verbindung zu GitHub, GitLab oder Visual Builder Studio herzustellen.

        Wenn Sie Bitbucket Cloud auswählen, wählen Sie den Vault-Wert und das App-Kennwort-Secret aus.

      • (Optional) Wählen Sie unter TLS-Verifizierungskonfiguration ein CA-Bundle zur Authentifizierung des selbst gehosteten Bitbucket- oder GitLab-Servers aus.

        Dies gilt nicht, wenn der Repository-Server (GitLab- oder Bitbucket-Server) bei der öffentlich vertrauenswürdigen Certificate Authority gehostet wird.

      • (Optional) Um der Verbindung Tags hinzuzufügen, klicken Sie auf Taggingoptionen anzeigen.

        Tagging ist ein Metadatensystem, mit dem Sie die Ressourcen in Ihrem Mandanten organisieren und verfolgen können.

        Wenn Sie über Berechtigungen zum Erstellen von Ressourcen verfügen, sind Sie auch berechtigt, Freiformtags hinzuzufügen.

        Um ein definiertes Tag hinzuzufügen, benötigen Sie Berechtigungen zum Verwenden des Tag-Namespace.

        Weitere Informationen finden Sie unter Ressourcentags.

    5. Klicken Sie auf Erstellen.
      Die Verbindung zum ausgewählten externen Repository wurde erfolgreich erstellt.
    Sie können jetzt ein Code-Repository aus GitHub, GitLab, Bitbucket Cloud oder Visual Builder Studio spiegeln. Siehe Repository spiegeln.

  • Um eine GitHub-Verbindung zu erstellen, führen Sie den Befehl create-github-connection aus:

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

    Um eine GitLab-Verbindung zu erstellen, führen Sie den Befehl create-gitlab-connection aus:

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

    Um eine Bitbucket Cloud-Verbindung zu erstellen, führen Sie den Befehl create-bitbucket-cloud-connection aus:

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

    Um eine Verbindung zu Visual Builder Studio zu erstellen, führen Sie den Befehl create-vbs-connection aus:

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

    Um eine Bitbucket Server-Verbindung zu erstellen, führen Sie den Befehl create-bitbucket-server-connection aus:

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

    Um eine GitLab Server-Verbindung zu erstellen, führen Sie den Befehl create-gitlab-server-connection aus:

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

    Um eine Liste der Verbindungen anzuzeigen, führen Sie den Befehl list aus:

    oci devops connection list

    So rufen Sie alle Befehle für connection ab:

    oci devops connection -h

  • Um eine externe Verbindung zu erstellen, verwenden Sie den Vorgang CreateConnection.