Git 接続の設定とテスト

新しいプロジェクトを作成すると、Development Mode でのみ存在し、他のユーザーに影響を与えない安全な環境でモデルを開発できます。プロジェクトを公開する準備ができたら、次のステップとして Git 接続を構成します。

プロジェクトの Git 接続を構成すると、LookML を本番環境モードにデプロイできます。これにより、他のユーザーがデータモデルを探索し、ダッシュボードを構築し、LookML をモデルに追加できます。設定を迅速に行うには、ベアリポジトリを使用します。より堅牢な Git 統合のためには、独自の Git リポジトリを作成し、このページの手順に沿って Looker インスタンスに接続します。

Looker と Git の統合

Looker では、変更の記録とファイルのバージョン管理のために、Git を使用します。 各 LookML プロジェクトは 1 つの Git リポジトリに対応します。ユーザーが Development Mode になるとそのユーザーは独自の Git ブランチにいます。

LookML のソースファイルの管理では、認証に SSH 認証鍵または HTTPS を使用する Git プロバイダを使用して Looker を構成できます。どのプラットフォームを使用する場合でも、一般的な手順は同じです。このページでは、Git リポジトリを作成した後に Looker プロジェクトを Git に接続する例として GitHub を使用します。

Git のインテグレーション オプションにアクセスするには、Development Mode をオンにする必要があります。

Git インテグレーションは、次のいずれかのプロトコルを使用して構成できます。

  • HTTPS: Hypertext Transfer Protocol SecureHTTPS では、HTTPS を使用した Git への接続で説明されているように、Looker は指定したユーザー名とパスワード(またはアクセス トークン)を使用して Git リポジトリにアクセスします。
  • SSH: Secure ShellSSH では、SSH を使用した Git への接続で説明されているように、Looker は Git プロバイダのウェブサイトを介して生成したデプロイキーを使用して Git リポジトリにアクセスします。

HTTPS を使用した Git への接続

HTTPS 認証で構成された LookML プロジェクトの場合、Looker は Git プロバイダで設定した 1 つ以上のユーザー アカウントを使用して Git プロバイダに接続します。Looker は、ユーザー名とパスワード(またはアクセス トークン)を使用して Git プロバイダにログインし、LookML デベロッパーに代わって Git オペレーションを実行します。

Git アカウントで 2 要素認証を使用している場合は、Git プロバイダに移動して、パスワードの代わりに使用するアクセス トークンを作成できます。一般的な Git プロバイダ向けの個人アクセス トークンの作成手順については、2FA 対応の HTTPS git 接続の設定コミュニティ投稿をご覧ください。

HTTPS 認証を使用すると、プロジェクト全体で 1 つの Git アカウントを使用するように LookML プロジェクトを構成することも、デベロッパーの個々の Git アカウントを使用して Git オペレーションを実行するようにプロジェクトを構成することもできます。

GitHub HTTPS 認証については、次の点に注意してください。

  • GitHub では、github.com での Git 操作の認証に使用するアカウント パスワードを受け付けていません。詳細については、GitHub のブログ投稿をご覧ください。HTTPS を使用して Looker プロジェクトを GitHub に接続するには、GitHub のデベロッパー設定を使用して個人用アクセス トークンを作成します。
  • Looker では、GitHub のきめ細かい個人用アクセス トークンはサポートされていません。HTTPS を使用して Looker プロジェクトを GitHub に接続するには、個人用のアクセス トークンを作成するときに GitHub のTokens (classic) のオプションを使用します。

単一アカウントの HTTPS 認証

単一の Git アカウントで LookML プロジェクトを設定した場合、Looker はその Git アカウントを使用して Git プロバイダにログインし、デベロッパーの代わりに変更を commit します。Looker では、デベロッパーの Looker ユーザー名を使用してこれらの commit を行っているため、各デベロッパーがどの commit を実行したかがわかります。プロジェクトの commit 履歴は、Git プロバイダのインターフェース上で、または Looker IDE の [Git] メニューから [History] オプションを選択すると確認できます。 Looker での Git メニューの詳細については、Looker での Git コマンドの実行をご覧ください。

単一アカウントの HTTPS 認証の場合、指定する Git ユーザー アカウントには、Git リポジトリへの読み取りおよび書き込みアクセス権が必要です。LookML デベロッパー自身が独自の Git ユーザー アカウントを持つ必要はありません。

ユーザー属性を使用した複数のアカウント HTTPS 認証

複数のアカウントで LookML プロジェクトを設定した場合、LookML プロジェクトは各 Looker デベロッパーの個々の Git アカウントを使用して Git オペレーションを実行します。また、Looker がファイルのプロダクション バージョンを pull するために使用する、少なくとも読み取りアクセス権を持つ汎用の Git ユーザー アカウントを 1 つ構成する必要があります。

ユーザー属性を使用した Git 認証には、次のタスクと要件が必要です。

  • LookML デベロッパーごとに、Git プロバイダのユーザー アカウントが必要です。各 Git ユーザー アカウントには、プロジェクトのリポジトリに対する読み取り / 書き込みアクセス権が必要です。
  • Looker 管理者は、Git ユーザー名とパスワードに対応するユーザー属性(Git ユーザー アカウントに 2 要素認証がある場合はアクセス トークン)を使用して、Looker ユーザー アカウントを設定する必要があります。
  • Git アカウント パスワード(またはアクセス トークン)のユーザー属性は非表示である必要があります。パスワードまたはアクセス トークン属性を作成するとき、[値を非表示] オプションで [Yes] を選択し、[ドメイン許可リスト] フィールドに Git プロバイダの URL を入力します。
  • Git の名前とパスワード(またはアクセス トークン)のユーザー属性は、Looker デベロッパーごとに設定する必要があります。ユーザー属性は、Looker 管理者または Looker ユーザーが構成できます。

次の例は、[ユーザー属性] 管理者ページを示しています。このページでは、Looker 管理者が Git ユーザー名とユーザー アクセス トークンのユーザー属性を設定します。

文字列型のユーザー属性 github_token と github_username を表示する [ユーザー属性] 管理者ページの表。

次の例は、ユーザーがユーザー属性フィールドに Git 認証情報を入力した Looker ユーザーの [アカウント] ページを示しています。

HTTPS Git 認証を構成する

HTTPS Git 認証を使用して LookML プロジェクトを構成する手順は次のとおりです。

  1. Git リポジトリの HTTPS URL を取得します。GitHub の場合、新しいリポジトリ(まだファイルが含まれていないリポジトリ)に対して、GitHub は初期設定の一部として URL を表示します。[コード] タブの [HTTPS] ボタンを選択して HTTPS URL を取得し、[URL をクリップボードにコピー] アイコンを選択してクリップボードにコピーします。

    既存の GitHub リポジトリ(すでにファイルが含まれているリポジトリ)の場合は、リポジトリの [コード] タブに移動して [コード] ボタンを選択すると、HTTPS URL を確認できます。[HTTPS] リンクを必ず選択してください。[URL をクリップボードにコピー] アイコンを選択して、HTTPS URL をクリップボードにコピーできます。

  2. LookML プロジェクトに移動し、ナビゲーション バーから [設定] アイコンを選択します。

  3. [プロジェクト 設定] ページの [設定] タブで、[Git の構成] ボタン(新しいプロジェクトの場合)または [Git 接続のリセット] ボタン(以前に Git に接続している既存のプロジェクト用)に移動します。

  4. [Git の構成] または [Git 接続のリセット] ボタンを選択して、[Git の構成] ページを開きます。

    Git 接続をリセットしても、メインブランチの Git 履歴は保持されます。また、pull、マージ、デプロイが行われた際に、各 Looker デベロッパーの個人用ブランチの履歴も保持されます。すべてのブランチの履歴を保持するには、新しい Git リポジトリへの移行のベスト プラクティスのページをご覧ください。

  5. Looker の [Git を構成] ページで、[リポジトリの URL] フィールドに Git リポジトリの HTTPS URL を貼り付けて、[続行] を選択します。

    Looker は Git プロバイダを検出し、Git リポジトリに関する情報でウィンドウを更新します。

    Looker で Git プロバイダの検出に失敗した場合は、プルダウンから選択するよう求められます。

  6. Git のログイン オプションを選択します。

  7. [ユーザー名] と [パスワード/個人アクセス トークン] に、Git へのアクセスに LookML プロジェクトが使用する認証情報を入力します。これは、Git ログイン設定に関係なく必要です。

    • [単一の一定のユーザー名とパスワード / 個人用アクセス トークンの組み合わせを使用する] を選択した場合、これは、Looker インスタンスがすべての Git 操作に使用する Git ユーザー名とパスワード (またはアクセス トークン) となります。この Git ユーザー アカウントには、Git リポジトリへの読み取りおよび書き込みアクセス権限が必要です。
    • [ユーザー名とパスワード/個人アクセス トークンにユーザー属性を使用する] を選択した場合、これは、Looker インスタンスがリポジトリの本番バージョンを取得するために使用する Git ユーザー名とパスワード (またはアクセス トークン) となります。この Git ユーザー アカウントには、Git リポジトリに対する読み取りアクセス権が必要です。

    Git アカウントで 2 要素認証を使用している場合や、GitHub を使用している場合(パスワードの代わりに個人用アクセス トークンが必要)は、Git プロバイダに移動して、パスワードの代わりに使用するアクセス トークンを作成できます。一般的な Git プロバイダ向けの個人アクセス トークンの作成手順については、2FA 対応の HTTPS git 接続の設定コミュニティ投稿をご覧ください。

  8. [Use user attributes for username and password/personal access token] を選択した場合、Looker には [Development Mode Credentials] セクションの [Username User Attribute] と [Personal Access Token User Attribute] プルダウンメニューが表示されます。プルダウン メニューを使用して、個々のデベロッパーの Git 認証情報のユーザー属性を選択します。

    (Looker ユーザーは [アカウント] ページでユーザー属性フィールドの値を編集できます。また、Looker 管理者は [ユーザー] 管理ページでユーザーのユーザー属性値を編集できます)。

  9. [Continue Setup] ボタンを選択します。

これで、LookML プロジェクト用に Git が構成されました。ここから、LookML を検証し、初期 commit を作成して本番環境にデプロイすることで、プロジェクトを本番環境モードで使用できるようにします。次の操作も行えます。

  • Git メニューを使用して Git コマンドにアクセスします。
  • Git メニューを使用して