Auf dieser Seite wird beschrieben, wie Sie Pipelines mithilfe der Versionsverwaltung in Cloud Data Fusion über Git-Repositories
Versionsverwaltung
Cloud Data Fusion bietet die Möglichkeit, Pipelines für ETL- und ELT-Integrationen visuell zu entwerfen. Für eine bessere Verwaltung von Pipelines zwischen Entwicklung und Produktion ermöglicht Cloud Data Fusion die Versionskontrolle der Pipelines mit GitHub und anderen Versionskontrollsystemen.
Mit der Versionsverwaltung in Cloud Data Fusion haben Sie folgende Möglichkeiten:
- Integrieren Sie jeden Cloud Data Fusion-Namespace in ein Versionskontrollsystem.
- Pipelines in einem zentralen Git-Repository verwalten
- Pipelineänderungen prüfen und analysieren.
- Änderungen an der Pipeline rückgängig machen.
- Effektiv mit dem Team zusammenarbeiten und gleichzeitig eine zentrale Kontrolle gewährleisten.
Hinweise
- Die Quellcodeverwaltung unterstützt die Integration mit GitHub-, Bitbucket-Server-, Bitbucket-Cloud- und Gitlab-Repositories.
- GitHub-OAuth wird nicht unterstützt.
- Versionsverwaltung unterstützt nur Batchpipelines.
- Die Versionsverwaltung unterstützt nur JSON-Dateien für Pipelinedesign für Push- und Pull-Vorgänge. Ausführungskonfigurationen werden nicht unterstützt.
- Die Größenbeschränkung für das verknüpfte Repository beträgt 5 GB.
Erforderliche Rollen und Berechtigungen
Die Verwaltung der Quellkontrolle in Cloud Data Fusion umfasst zwei wichtige Vorgänge:
- Repositories für die Versionskontrolle konfigurieren
- Pipelines mit Git-Repositories mithilfe von Push- und Pull-Vorgängen synchronisieren
Bitten Sie Ihren Administrator, Ihnen eine der folgenden vordefinierten Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Verwendung der Funktion „Verwaltung der Quellcodeverwaltung“ benötigen:
Versionsverwaltungs-Repository konfigurieren:
- Cloud Data Fusion-Operator (
roles/datafusion.operator
) - Cloud Data Fusion-Bearbeiter (
roles/datafusion.editor
) - Cloud Data Fusion-Administrator (
roles/datafusion.admin
)
- Cloud Data Fusion-Operator (
Synchronisieren Sie Pipelines mit Push- oder Pull-Vorgängen aus einem Namespace:
- Cloud Data Fusion-Operator (
roles/datafusion.operator
) - Cloud Data Fusion-Entwickler (
roles/datafusion.developer
) - Cloud Data Fusion-Bearbeiter (
roles/datafusion.editor
) - Cloud Data Fusion-Administrator (
roles/datafusion.admin
)
- Cloud Data Fusion-Operator (
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.
Möglicherweise können Sie die erforderlichen Berechtigungen auch über andere vordefinierte Rollen erhalten.
Git-Repository einrichten
Folgen Sie der Anleitung unter Repository erstellen, um ein Git-Repository in GitHub zu erstellen.
Weitere Informationen zu persönlichen Zugriffstokens in GitHub und anderen Versionen finden Sie auf den folgenden Seiten:
Git-Repository mit Cloud Data Fusion verbinden
In Cloud Data Fusion können Sie Ihr Git-Repository auf dem Tab „Versionsverwaltung“ für jeden Namespace konfigurieren und verbinden. So verknüpfen Sie einen Namespace mit Ihrem Git-Repository:
Console
- Klicken Sie in Cloud Data Fusion Studio auf Menü.
- Klicken Sie auf Namespace-Verwaltung.
- Klicken Sie auf der Seite Namespace-Verwaltung auf Verwaltung des Quellsteuerelements. .
- Klicken Sie auf Repository verknüpfen.
Geben Sie die folgenden Informationen ein:
- Anbieter: Wählen Sie einen Git-Dienstanbieter wie GitHub oder GitLab aus.
- Repository-URL: Geben Sie die URL ein, unter der sich das Repository befinden kann.
Zugriff haben. Für GitHub lautet die Repository-URL
https://github.com/HOST/REPO
- Standardzweig (optional): Geben Sie den ursprünglichen Git-Zweig ein. Dieser Branch kann sich vom auf GitHub konfigurierten Standard-Branch unterscheiden. Dieser Branch wird unabhängig vom Standard-Branch auf GitHub zum Synchronisieren von Pipelines verwendet.
- Pfadpräfix (optional): Geben Sie ein Präfix für den Pipelinenamen ein, das im Git-Repository gespeichert wird. Wenn der Name Ihrer Pipeline beispielsweise
DataFusionQuickStart
lautet und Sie das PräfixnamespaceName
angeben, wird die Pipeline im Git-Repository alsnamespaceName/DataFusionQuickStart
gespeichert. - Authentifizierungstyp: In Cloud Data Fusion können Sie das personalisierte Zugriffstoken als Authentifizierungstyp verwenden. Dies ist automatisch ausgewählt.
- Tokenname: Geben Sie einen Namen ein, der mit dem Token verknüpft werden kann.
- Token: Geben Sie das Token ein, das vom GitHub-Repository bereitgestellt wird.
- Optional: Nutzername: Geben Sie einen Nutzernamen oder einen Inhaber für das Token ein.
Klicke auf Validieren. Warten Sie, bis die Verbindung bestätigt wurde.
Wenn die Konfiguration abgeschlossen ist, klicken Sie auf Save and Close (Speichern und schließen). Konfiguration.
REST API
Erstellen Sie einen geheimen Schlüssel in Cloud Data Fusion mit dem persönlichen Zugriffstoken.
Führen Sie dazu diesen Befehl aus:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" ${CDAP_ENDPOINT}/v3/namespaces/NAMESPACE_ID/securekeys/PASSWORD_SECRET_KEY -X PUT -d '{ "description": "Example Secure Key","data": "PERSONAL_ACCESS_TOKEN"}'
Ersetzen Sie Folgendes:
NAMESPACE_ID
: die ID des Namespace.PASSWORD_SECRET_KEY
: der Name des Secrets Schlüssel, der persönliches Zugriffstoken enthält.PERSONAL_ACCESS_TOKEN
: persönlicher Zugriff Token von GitHub.
Führen Sie dazu diesen Befehl aus:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" ${CDAP_ENDPOINT}/v3/namespaces/NAMESPACE_ID/repository -X PUT -d '{"test": "TEST_ONLY", "config": {"provider": "PROVIDER_TYPE", "link": "REPO_URL", "defaultBranch": "DEFAULT_BRANCH", "pathPrefix": "PATH_TO_DIRECTORY", "auth": {"type": "AUTH_TYPE", "patConfig": {"passwordName": "PASSWORD_SECRET_KEY", "username": "USER_NAME"}}}}'
Ersetzen Sie Folgendes:
NAMESPACE_ID
: die ID des Namespace.TEST_ONLY
: Legen Sietrue
fest, wenn Sie möchten die Konfiguration nur zu validieren und nicht zu ihr hinzuzufügen.PROVIDER_TYPE
: der Name des Git-Anbieters, der istGITHUB
.REPO_URL
: Die zu verknüpfende Repository-URL. Verwenden Sie Einehttps
-URL, z. B.https://github.com/user/repo.git
.DEFAULT_BRANCH
: Branch, der für Push- und Pull-Vorgänge verwendet wird. Wenn nichts angegeben ist, wird der standardmäßig konfigurierte Zweig im Repository verwendet, z. B. der Hauptzweig.PATH_TO_DIRECTORY
: Pfad zum Verzeichnis in Das Repository, in dem die Konfigurationsdateien gespeichert sind.AUTH_TYPE
: der Authentifizierungstyp. Es wird nurPAT
unterstützt. Siehe Detailgenaues persönliches Zugriffstoken in GitHubPASSWORD_SECRET_KEY
: Der Name des geheimen Schlüssels, der das persönliche Zugriffstoken für den AuthentifizierungstypPAT
enthält.USER_NAME
: Sie können diesen Wert für den AuthentifizierungstypPAT
weglassen.
Cloud Data Fusion-Pipelines mit einem Remote-Repository synchronisieren
Nachdem Sie ein Git-Repository mit einem Namespace konfiguriert haben, können Sie Daten hoch- und herunterladen und synchronisieren sie mit dem Git-Repository.
Pipelines aus Cloud Data Fusion in ein Git-Repository pushen
So synchronisieren Sie mehrere bereitgestellte Pipelines aus einem Namespace mit einem Git-Repository:
Console
- Klicken Sie in Cloud Data Fusion Studio auf Menü.
- Klicken Sie auf Namespace-Verwaltung.
- Klicken Sie auf der Seite Namespace-Verwaltung auf Verwaltung des Quellsteuerelements. .
- Suchen Sie das Git-Repository, mit dem Sie eine Synchronisierung durchführen möchten, und Klicken Sie auf Sync pipelines (Pipelines synchronisieren).
- Klicken Sie auf den Tab Namespace-Pipelines.
Suchen Sie nach den Pipelines, die Sie an Git übertragen möchten, und wählen Sie sie aus zu erstellen.
Wenn die neueste Version der Pipeline in Git übertragen oder daraus abgerufen wird Repository enthalten, wird für den Status Mit Git verbunden der Status
Connected
angezeigt. Wenn der Parameter Pipeline wurde nie an GitHub übertragen, der Status Mit Git verbunden wird angezeigt ist leer (-
).Wenn Sie eine neuere Version einer Pipeline bereitstellen, die bereits mit dem Git-Repository synchronisiert ist, ändert sich der Status Mit Git verbunden von
Connected
in leer (-
).Klicken Sie auf An Repository senden.
Geben Sie eine Commit-Nachricht ein und klicken Sie auf OK.
Der Push-Vorgang wird gestartet und eine Meldung wird angezeigt, dass die ausgewählten Pipelines in das Remote-Repository gepusht werden.
Wenn der Push-Vorgang erfolgreich abgeschlossen wurde, wird eine Erfolgsmeldung angezeigt. mit der Anzahl der Pipelines, die an das Remote- zu erstellen.
Wenn der Push-Vorgang fehlschlägt, sehen Sie in der Pipeline in GitHub nach, ob es sich um den aktuelle Version. Bei jedem fehlgeschlagenen Push-Vorgang wird eine Fehlermeldung angezeigt. Wenn Sie sich die Details des Fehlers ansehen möchten, maximieren Sie die Fehlermeldung.
Sie können auch einzelne Pipelines aus dem Pipeline Design Studio in ein Git-Repository verschieben:
- Klicken Sie in Cloud Data Fusion Studio auf Menü.
- Klicken Sie auf Liste.
- Klicken Sie auf die Pipeline, die Sie in das Git-Repository pushen möchten.
- Klicken Sie auf der Pipeline-Seite auf Aktionen > An Repository senden
- Geben Sie eine Commit-Nachricht ein und klicken Sie auf OK.
REST API
Pipelines aus Cloud Data Fusion in das Git-Repository pushen:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" ${CDAP_ENDPOINT}/v3/namespaces/NAMESPACE_ID/repository/apps/push -X POST -d '{"apps": ["PIPELINE_NAME_1", "PIPELINE_NAME_2"]}, "commitMessage": "COMMIT_MESSAGE"'
Ersetzen Sie Folgendes:
NAMESPACE_ID
: die ID des Namespace.PIPELINE_NAME_1
,PIPELINE_NAME_2
: Namen der Pipelines, die gepusht werden sollen.COMMIT_MESSAGE
: Commit-Nachricht für Git Commit durchführen.
Die Antwort enthält die ID des Push-Vorgangs. Beispiel:
RESPONSE { "id": OPERATION_ID }
Führen Sie den folgenden Befehl aus, um den Status des Push-Vorgangs abzufragen:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" ${CDAP_ENDPOINT}/v3/namespaces/NAMESPACE_ID/operations/OPERATION_ID
Ersetzen Sie Folgendes:
NAMESPACE_ID
: die ID des Namespace.OPERATION_ID
: die Vorgangs-ID, die von der Push-Operation.
Die Antwort enthält den Status des Push-Vorgangs. Beispiel:
RESPONSE { "id": OPERATION_ID "done": True/False "status": STARTING/RUNNING/SUCCEEDED/FAILED "error": {"message": ERROR_MESSAGE, "details":[{"resourceUri": RESOURCE, "message": ERROR_MESSAGE}]} }
Prüfen Sie im
done
, ob der Push-Vorgang abgeschlossen ist. in der Antwort angeben. Wenn der Vorgang fehlgeschlagen ist, sehen Sie in der Propertyerror
nach, um weitere Informationen zu erhalten.
Pipelines aus dem Git-Repository in Cloud Data Fusion abrufen
So synchronisieren Sie mehrere Pipelines aus einem Git-Repository mit Ihrem Namespace: Schritte:
Console
- Klicken Sie in Cloud Data Fusion Studio auf Menü.
- Klicken Sie auf Namespace-Verwaltung.
- Klicken Sie auf der Seite Namespace-Administrator auf den Tab Verwaltung der Quellkontrollfunktion.
- Suchen Sie das Git-Repository, mit dem Sie synchronisieren möchten, und klicken Sie auf Pipelines synchronisieren.
- Klicken Sie auf den Tab Repository-Pipelines. Alle im Git-Repository gespeicherten Pipelines werden angezeigt.
- Suchen Sie nach den Pipelines, die Sie aus dem Git-Repository in Ihren Cloud Data Fusion-Namespace ziehen möchten, und wählen Sie sie aus.
Klicken Sie auf Aus Repository abrufen.
Der Pull-Vorgang wird gestartet und in einer Meldung wird angezeigt, dass der ausgewählte Pipelines werden aus dem Remote-Repository abgerufen. Cloud Data Fusion sucht unter dem konfigurierten Pfad nach JSON-Dateien, ruft sie ab und implementiert sie als Pipelines in Cloud Data Fusion.
Wenn der Pull-Vorgang erfolgreich abgeschlossen wurde, wird eine Erfolgsmeldung angezeigt. mit der Anzahl der Pipelines, die aus dem Remote-Repository.
Wenn der Pull-Vorgang fehlschlägt, wird eine Fehlermeldung angezeigt. Maximieren Sie die Fehlermeldung, um die Details des Fehlers aufzurufen.
Sie können auch einzelne Pipelines von einem Git-Repository in einen Namespace abrufen. Pipeline-Designstudio erhalten:
- In Cloud Data Fusion Studio Klicken Sie auf Menü.
- Klicken Sie auf Liste.
- Klicken Sie auf die Pipeline, die Sie aus dem Git-Repository abrufen möchten.
- Klicken Sie auf der Pipeline-Seite auf Aktionen > Aus dem Repository abrufen
REST API
Rufen Sie eine Reihe von Pipelines aus dem Git-Repository in Cloud Data Fusion ab:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" ${CDAP_ENDPOINT}/v3/namespaces/NAMESPACE_ID/repository/apps/pull -X POST -d '{"apps": ["PIPELINE_NAME_1", "PIPELINE_NAME_2"]}'
Ersetzen Sie Folgendes:
NAMESPACE_ID
: die ID des Namespace.PIPELINE_NAME_1
,PIPELINE_NAME_2
: Namen der Pipelines, die abgerufen werden sollen.
Die Antwort enthält die ID des Pull-Vorgangs. Beispiel:
RESPONSE { "id": OPERATION_ID }
Führen Sie folgenden Befehl aus, um den Status des Pull-Vorgangs abzufragen:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" ${CDAP_ENDPOINT}/v3/namespaces/NAMESPACE_ID/operations/OPERATION_ID
Ersetzen Sie Folgendes:
NAMESPACE_ID
: die ID des Namespace.OPERATION_ID
: Die Vorgangs-ID, die vom Pull-Vorgang empfangen wurde.
Die Antwort enthält den Status des Pull-Vorgangs. Beispiel:
RESPONSE { "id": OPERATION_ID "done": True/False "status": STARTING/RUNNING/SUCCEEDED/FAILED "error": {"message": ERROR_MESSAGE, "details":[{"resourceUri": RESOURCE, "message": ERROR_MESSAGE}]} }
Prüfe in der Antwort, ob der Pull-Vorgang abgeschlossen ist. Sieh dazu in der Antwort nach der Eigenschaft
done
. Wenn der Vorgang fehlgeschlagen ist, prüfen Sie denerror
. .
Konfiguration des Git-Repositories löschen
So löschen Sie die Git-Repository-Konfiguration aus einem Namespace:
Console
- Klicken Sie in Cloud Data Fusion Studio auf Menü.
- Klicken Sie auf Namespace-Verwaltung.
- Klicken Sie auf der Seite Namespace-Verwaltung auf Verwaltung des Quellsteuerelements. .
- Klicken Sie für die zu löschende Git-Repository-Konfiguration auf > Löschen.
REST API
Löschen Sie die Git-Repository-Konfiguration:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)"
${CDAP_ENDPOINT}/v3/namespaces/NAMESPACE_ID/repository -X DELETE
Ersetzen Sie NAMESPACE_ID durch die ID der -Namespace auf sie zugegriffen werden.
Nächste Schritte
- Weitere Informationen zu GitHub-Repository zum Verwalten von Pipelines verwenden