dbt Gitリポジトリ

概要

dbtジョブを実際に実行する前に、TROCCOにGitリポジトリを連携する必要があります。
本記事では、dbt Gitリポジトリの作成・編集・削除について説明します。

IPアドレスの許可依頼

GitHub Enterpriseなどを用いて、Gitサーバーに対して特定のIPアドレス以外からのアクセスを拒否している場合は、TROCCOが通信に利用するIPアドレスに対してアクセスを許可してください。
セキュリティグループやファイアウォール等で許可頂く必要があるIPアドレス

GitHubをお使いの場合

以下のURLからDeploy Keyを登録できます。
https://github.com/<GitHubユーザー名>/<リポジトリ名>/settings/keys

項目名	必須	内容
リポジトリURL	Yes	対象となるリポジトリのURLを入力します。 GitSSH形式での入力にのみ対応しています。
参照タイプ	Yes	参照先の種別を選択します。「ブランチ」「タグ」「コミットハッシュ」のいずれかを指定できます。詳しくは、参照タイプの使い分けを参照ください。
ブランチ名	Yes	参照タイプでブランチを選択した場合に入力します。対象となるブランチ名を指定してください。
タグ名	Yes	参照タイプでタグを選択した場合に入力します。対象となるタグ名を指定してください。
コミットハッシュ	Yes	参照タイプでコミットハッシュを選択した場合に入力します。コミットハッシュを40桁の16進数（0-9、a-f）で指定してください。短縮形式や大文字は使用できません。
サブディレクトリ	No	Gitリポジトリ内のサブディレクトリをプロジェクトディレクトリとして指定できます。 `dbt_project.yml`がルートディレクトリ直下にないようなケースに入力してください。なお、リポジトリのルートディレクトリをプロジェクトディレクトリとして指定する場合は、何も入力しないでください。
dbt バージョン	Yes	利用するdbt Coreのバージョンを選択できます。

参照タイプは、dbtリポジトリ側のブランチ戦略やデプロイ運用に応じて選択します。

ブランチ: リポジトリ側で開発環境用ブランチと本番環境用ブランチを分けて運用しているケースに適しています。たとえば、developを開発環境、mainを本番環境として運用している場合、それぞれのブランチに対応するdbt Gitリポジトリ設定を作成して使い分けます。
タグ: 環境ごとにdbt連携ジョブのバージョン切り替えを精緻に管理したいケースに適しています。たとえば、ステージング環境では先行のタグを参照し、検証成功を確認してから本番環境のタグを更新することで、安全なリリースフローを構築できます。
コミットハッシュ: タグの上書きなどによるバージョンの取り違えを避け、コミット単位で厳密に振る舞いを固定したいケースに適しています。サプライチェーン上の懸念がある場合にも有効です。

同一リポジトリで複数の設定を作成する

同一のGitリポジトリに対して、参照タイプの異なる複数のdbt Gitリポジトリ設定を作成できます。
これにより、1つのGitリポジトリを共有しながら、環境ごとに異なるdbtジョブの実行を管理できます。

チーム機能をご利用の場合

dbt Gitリポジトリは、TROCCOにおいてリソースとして扱われます。

操作＼ロール	リソースグループ管理者	リソースグループ編集者	リソースグループ運用者	リソースグループ閲覧者	ロール無し	補足
dbt Gitリポジトリの編集	✓	✓	-	-	-
dbt Gitリポジトリの削除	✓	✓	-	-	-
dbt Gitリポジトリの運用	✓	✓	✓	-	-	dbtジョブ設定に利用できます。
dbt Gitリポジトリの新規追加	✓	✓	✓	✓	✓