Mit Bereitstellungen können Sie Code wie Pipelines planen, der in Remote-Git-Repositories gespeichert ist. Sie können das Verzeichnis auswählen, in dem sich Ihr Code befindet, und die folgenden Aktionen ausführen:
- Mit Remote-Repositories verbundene Bereitstellungen erstellen und verwalten.
- Trigger konfigurieren, um Code aus Remote-Repositories abzurufen und regelmäßig auszuführen.
- Pipelines nach Zeitplan oder mit anderen Triggern ausführen.
- Logs Ihrer Ausführungen direkt in der Google Cloud Console ansehen. Für Benachrichtigungen werden Dataform-Bereitstellungen in Cloud Logging und Cloud Monitoring eingebunden.
Beschränkungen
- Bereitstellungen haben keine integrierten Benachrichtigungen. Sie müssen Logging und Monitoring verwenden, um Benachrichtigungen zu konfigurieren.
- Die Authentifizierung mit Developer Connect unterstützt nur Verbindungen und keine Kontoverbindungen.
Hinweis
Führen Sie die folgenden Aufgaben aus, bevor Sie eine Bereitstellung erstellen:
- Aktivieren Sie die Verwendung der Seite Pipelines und Verbindungen in der Google Cloud Console.
Aktivieren Sie die BigQuery API, die Dataform API und die Developer Connect API:
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen der Aufgaben in diesem Dokument benötigen:
- Dataform-Administrator (
roles/dataform.admin) für das Projekt - BigQuery Job User (
roles/bigquery.jobUser) für das Projekt - Developer Connect Viewer (
roles/developerconnect.viewer) für das Projekt -
Benutzerdefiniertes Dienstkonto zum Ausführen einer Bereitstellung verwenden:
Dienstkontonutzer (
roles/iam.serviceAccountUser) für das benutzerdefinierte Dienstkonto
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Wenn Sie ein benutzerdefiniertes Dienstkonto zum Ausführen einer Bereitstellung verwenden möchten, müssen Sie dem benutzerdefinierten Dienstkonto auch die
Rolle „BigQuery-Datenbearbeiter“
(roles/bigquery.dataEditor) zuweisen.
Deployment erstellen
So erstellen Sie eine Dataform-Bereitstellung:
Rufen Sie in der Google Cloud Console die Seite Pipelines und Verbindungen auf.
Klicken Sie auf Erstellen > Deployment erstellen.
Wählen Sie einen Authentifizierungstyp für das Repository und dann eine der folgenden Optionen aus:
Developer Connect
- Wählen Sie ein Repository und einen Zweig aus.
- Geben Sie den Pfad für das Verzeichnis ein, in dem sich der Code befindet.
- Geben Sie einen Namen für die Bereitstellung ein.
- Wählen Sie eine Region für die Bereitstellung aus.
Führen Sie im Abschnitt Planungshäufigkeit folgende Schritte aus:
- Wählen Sie im Menü Wiederholungen die Häufigkeit der geplanten Pipelineausführungen aus.
- Geben Sie im Feld Um die Uhrzeit die Zeit für die geplanten Pipelineausführungen ein.
- Wählen Sie im Menü Zeitzone die Zeitzone für den Zeitplan aus.
Alternativ können Sie On-Demand auswählen, um Ihre Bereitstellung bei Bedarf auszuführen.
Optional: Geben Sie die Google Cloud Projekt-ID ein.
Optional: Geben Sie ein Schemasuffix ein.
Optional: Geben Sie ein Tabellenpräfix ein.
Optional: Geben Sie das Standardschema ein.
Optional: Geben Sie Kompilierungsvariablen ein.
Klicken Sie auf Bereitstellen.
HTTPS
- Geben Sie die URL Ihres Remote-Git-Repositorys ein.
- Wählen Sie einen Zweig aus.
- Geben Sie den Pfad für das Verzeichnis ein, in dem sich der Code befindet.
- Geben Sie das Secret mit dem persönlichen Zugriffstoken für HTTPS-Remote-Verbindungen ein. Weitere Informationen finden Sie unter Remote-Repository über HTTPS verbinden.
- Geben Sie einen Namen für die Bereitstellung ein.
- Wählen Sie eine Region für die Bereitstellung aus.
Führen Sie im Abschnitt Planungshäufigkeit folgende Schritte aus:
- Wählen Sie im Menü Wiederholungen die Häufigkeit der geplanten Pipelineausführungen aus.
- Geben Sie im Feld Um die Uhrzeit die Zeit für die geplanten Pipelineausführungen ein.
- Wählen Sie im Menü Zeitzone die Zeitzone für den Zeitplan aus.
Alternativ können Sie On-Demand auswählen, um Ihre Bereitstellung bei Bedarf auszuführen.
Optional: Geben Sie die Google Cloud Projekt-ID ein.
Optional: Geben Sie ein Schemasuffix ein.
Optional: Geben Sie ein Tabellenpräfix ein.
Optional: Geben Sie das Standardschema ein.
Optional: Geben Sie Kompilierungsvariablen ein.
Klicken Sie auf Bereitstellen.
SSH
- Geben Sie die URL Ihres Remote-Git-Repositorys ein.
- Wählen Sie einen Zweig aus.
- Geben Sie den Pfad für das Verzeichnis ein, in dem sich der Code befindet.
- Geben Sie das Secret mit einem privaten Nutzerschlüssel und dem öffentlichen SSH-Hostschlüsselwert ein. Weitere Informationen finden Sie unter Remote-Repository über SSH verbinden.
- Geben Sie einen Namen für die Bereitstellung ein.
- Wählen Sie eine Region für die Bereitstellung aus.
Führen Sie im Abschnitt Planungshäufigkeit folgende Schritte aus:
- Wählen Sie im Menü Wiederholungen die Häufigkeit der geplanten Pipelineausführungen aus.
- Geben Sie im Feld Um die Uhrzeit die Zeit für die geplanten Pipelineausführungen ein.
- Wählen Sie im Menü Zeitzone die Zeitzone für den Zeitplan aus.
Alternativ können Sie On-Demand auswählen, um Ihre Bereitstellung bei Bedarf auszuführen.
Optional: Geben Sie die Google Cloud Projekt-ID ein.
Optional: Geben Sie ein Schemasuffix ein.
Optional: Geben Sie ein Tabellenpräfix ein.
Optional: Geben Sie das Standardschema ein.
Optional: Geben Sie Kompilierungsvariablen ein.
Klicken Sie auf Bereitstellen.
Deployments auflisten
So listen Sie die erstellten Bereitstellungen auf:
Rufen Sie in der Google Cloud Console die Seite Pipelines und Verbindungen auf.
Sehen Sie sich die Liste der Bereitstellungen an.
Deployment-Zeitplan erstellen
So erstellen Sie einen Zeitplan für eine Bereitstellung:
Rufen Sie in der Google Cloud Console die Seite Pipelines und Verbindungen auf.
Klicken Sie auf den Tab Deployments und wählen Sie dann eine Bereitstellung aus.
Klicken Sie auf der Seite Deployment-Details im Abschnitt Trigger (Workflowkonfigurationen) auf Erstellen.
Folgen Sie im Bereich Workflowkonfiguration erstellen der Anleitung, um eine Workflowkonfiguration zu erstellen.
Deployment-Zeitplan ausführen
So führen Sie einen Zeitplan für eine Bereitstellung aus:
Rufen Sie in der Google Cloud Console die Seite Pipelines und Verbindungen auf.
Klicken Sie auf den Tab Deployments und wählen Sie dann eine Bereitstellung aus.
Klicken Sie im Abschnitt Trigger (Workflowkonfigurationen) neben dem Bereitstellungszeitplan, den Sie ausführen möchten, auf Aktionen ansehen > Jetzt ausführen.
Deployment-Zeitplan löschen
So löschen Sie einen Zeitplan für eine Bereitstellung:
Rufen Sie in der Google Cloud Console die Seite Pipelines und Verbindungen auf.
Klicken Sie auf den Tab Deployments und wählen Sie dann eine Bereitstellung aus.
Klicken Sie auf der Seite Deployment-Details im Abschnitt Trigger (Workflowkonfigurationen) neben dem Bereitstellungs zeitplan, den Sie löschen möchten, auf Aktionen ansehen > Löschen.
Benachrichtigungen konfigurieren
Wenn Sie Benachrichtigungen erhalten möchten, wenn eine Workflowausführung fehlschlägt, konfigurieren Sie Benachrichtigungen für fehlgeschlagene Workflowaufrufe.