デプロイの作成と管理

デプロイメントを使用すると、リモート Git リポジトリに保存されているコード（パイプラインなど）の実行をスケジュール設定できます。コードが保存されているディレクトリを選択して、次の操作を行うことができます。

  • リモート リポジトリに接続されたデプロイメントを作成して管理します。
  • リモート リポジトリからコードを pull して定期的にコードを実行するようにトリガーを構成します。
  • スケジュールまたは他のトリガーを使用してパイプラインを実行します。
  • コンソール内で実行のログを直接表示します。 Google Cloud アラートの場合、Dataform デプロイメントは Cloud Logging および Cloud Monitoring と統合されます。

制限事項

  • デプロイメントにはアラート機能が組み込まれていません。アラートを構成するには、Logging と Monitoring を使用する必要があります。
  • Developer Connect を使用した認証では、接続のみがサポートされ、アカウント コネクタはサポートされません。

始める前に

デプロイメントを作成する前に、次のタスクを完了します。

必要なロール

このドキュメントのタスクを実行するために必要な権限を取得するには、次の IAM ロールを付与するように管理者へ依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。

カスタム サービス アカウントを使用してデプロイメントを実行するには、カスタム サービス アカウントに BigQuery データ編集者ロール （roles/bigquery.dataEditor）も付与する必要があります。

Deployment の作成

Dataform デプロイメントを作成する手順は次のとおりです。

  1. コンソールで、[パイプラインと接続] ページに移動します。 Google Cloud

    [パイプラインと接続] に移動

  2. [作成] > [デプロイメントの作成] をクリックします。

  3. リポジトリの認証タイプを選択し、次のいずれかのオプションを選択します。

    Developer Connect

    1. リポジトリとブランチを選択します。
    2. コードが保存されているディレクトリのパスを入力します。
    3. デプロイメントの名前を入力します。
    4. デプロイメントのリージョンを選択します。

    5. [スケジュールの頻度] セクションで、次の操作を行います。

      1. [繰り返しの頻度] メニューで、スケジュールされたパイプライン実行の頻度を選択します。
      2. [時刻] フィールドに、スケジュールされたパイプラインの実行時刻を入力します。
      3. [タイムゾーン] メニューで、スケジュールのタイムゾーンを選択します。

      または、[オンデマンド] を選択して、デプロイメントをオンデマンドで実行します。

    6. 省略可: Google Cloud プロジェクト ID を入力します。

    7. 省略可: スキーマ接尾辞を入力します。

    8. 省略可: テーブル接頭辞を入力します。

    9. 省略可: デフォルトのスキーマを入力します 。

    10. 省略可: コンパイル変数を入力します。

    11. [デプロイ] をクリックします。

    HTTPS

    1. リモートの Git リポジトリの URL を入力します。
    2. ブランチを選択します。
    3. コードが保存されているディレクトリのパスを入力します。
    4. HTTPS リモートの個人アクセス トークンを含むシークレットを入力します。詳細については、 HTTPS 経由でリモート リポジトリに接続するをご覧ください。
    5. デプロイメントの名前を入力します。
    6. デプロイメントのリージョンを選択します。

    7. [スケジュールの頻度] セクションで、次の操作を行います。

      1. [繰り返しの頻度] メニューで、スケジュールされたパイプライン実行の頻度を選択します。
      2. [時刻] フィールドに、スケジュールされたパイプラインの実行時刻を入力します。
      3. [タイムゾーン] メニューで、スケジュールのタイムゾーンを選択します。

      または、[オンデマンド] を選択して、デプロイメントをオンデマンドで実行します。

    8. 省略可: Google Cloud プロジェクト ID を入力します。

    9. 省略可: スキーマ接尾辞を入力します。

    10. 省略可: テーブル接頭辞を入力します。

    11. 省略可: デフォルトのスキーマを入力します 。

    12. 省略可: コンパイル変数を入力します。

    13. [デプロイ] をクリックします。

    SSH

    1. リモートの Git リポジトリの URL を入力します。
    2. ブランチを選択します。
    3. コードが保存されているディレクトリのパスを入力します。
    4. ユーザーの秘密鍵と SSH 公開ホスト鍵の値を含むシークレットを入力します。詳細については、 SSH 経由でリモート リポジトリに接続するをご覧ください。
    5. デプロイメントの名前を入力します。
    6. デプロイメントのリージョンを選択します。

    7. [スケジュールの頻度] セクションで、次の操作を行います。

      1. [繰り返しの頻度] メニューで、スケジュールされたパイプライン実行の頻度を選択します。
      2. [時刻] フィールドに、スケジュールされたパイプラインの実行時刻を入力します。
      3. [タイムゾーン] メニューで、スケジュールのタイムゾーンを選択します。

      または、[オンデマンド] を選択して、デプロイメントをオンデマンドで実行します。

    8. 省略可: Google Cloud プロジェクト ID を入力します。

    9. 省略可: スキーマ接尾辞を入力します。

    10. 省略可: テーブル接頭辞を入力します。

    11. 省略可: デフォルトのスキーマを入力します 。

    12. 省略可: コンパイル変数を入力します。

    13. [デプロイ] をクリックします。

デプロイのリスト表示

作成したデプロイメントを一覧表示する手順は次のとおりです。

  1. コンソールで、[パイプラインと接続] ページに移動します。 Google Cloud

    [パイプラインと接続] に移動

  2. デプロイメントのリストを表示します。

デプロイメント スケジュールを作成する

デプロイメントのスケジュールを作成する手順は次のとおりです。

  1. コンソールで、[パイプラインと接続] ページに移動します。 Google Cloud

    [パイプラインと接続] に移動

  2. [デプロイメント] タブをクリックし、デプロイメントを選択します。

  3. [デプロイメントの詳細] ページの [トリガー（ワークフロー構成）] セクションで、[作成] をクリックします。

  4. In the [**ワークフロー構成の作成**] ペインで、 ワークフロー構成を作成する手順に沿って操作します。

デプロイメント スケジュールを実行する

デプロイメントのスケジュールを実行する手順は次のとおりです。

  1. コンソールで、[パイプラインと接続] ページに移動します。 Google Cloud

    [パイプラインと接続] に移動

  2. [デプロイメント] タブをクリックし、デプロイメントを選択します。

  3. [トリガー（ワークフロー構成）] セクションで、実行する デプロイメント スケジュールの横にある [アクションを表示 > 今すぐ実行] をクリックします。

デプロイメント スケジュールを削除する

デプロイメントのスケジュールを削除する手順は次のとおりです。

  1. コンソールで、[パイプラインと接続] ページに移動します。 Google Cloud

    [パイプラインと接続] に移動

  2. [デプロイメント] タブをクリックし、デプロイメントを選択します。

  3. [**デプロイメントの詳細**] ページの [**トリガー（ワークフロー構成）**] セクションで、削除するデプロイメント スケジュールの横にある [**アクションを表示 > 削除**] をクリックします。

アラートの設定

ワークフローの実行が失敗したときに通知を受け取るには、 失敗したワークフロー呼び出しに対するアラートを構成します。

次のステップ