このページの内容は、プロジェクトがバージョン管理用にすでに設定されていることを前提としています。このページで説明されている選択肢の代わりに [Git の構成] ボタンが表示されている場合は、最初にプロジェクトの Git を設定する必要があります。
Looker では、変更の記録とファイルのバージョン管理のために、Git を使用します。 各 LookML プロジェクトは Git リポジトリに対応しており、各デベロッパー ブランチは Git ブランチに関連付けられています。
Looker は、多くの Git プロバイダ（GitHub、GitLab、Bitbucket など）と連携するように構成できます。Looker プロジェクト用の Git の設定については、Git 接続の設定とテストのドキュメント ページをご覧ください。
Git ブランチの操作
Git の主な利点の 1 つは、Looker のデベロッパーがブランチ（ファイル リポジトリの分離されたバージョン）で作業できる点です。他のユーザーに影響を与えることなく開発とテストを行うことができます。Looker のデベロッパーは、Development Mode のときは常に Git ブランチを使用します。
Git のもう 1 つの主な特長は、他のデベロッパーとの共同作業のしやすさです。ブランチを作成し、必要に応じて変更を行うと、他のデベロッパーがそのブランチに切り替えて、ブランチを確認または変更できます。別のデベロッパーがブランチへの変更を commit した場合、Looker には [リモートの変更をプル] ボタンが表示されます。追加の変更を加える前に、commit された変更をブランチに pull する必要があります。
マスターブランチ、現在のブランチ、デベロッパーの個人用ブランチ以外のブランチを削除することもできます。
個人用のブランチ
初めて Development Mode に入ると、Looker によって個人の Git ブランチが自動的に作成されます。dev- で始まり、ユーザー名が含まれる個人用ブランチ。
個人用ブランチはユーザー固有のもので、削除できません。個人用ブランチは他のすべてのデベロッパーに対して読み取り専用になります。プロジェクトで他のデベロッパーとコラボレーションしている場合は、新しいブランチを作成することで、そのブランチに切り替えたり、変更を提供したりできます。
新しい Git ブランチを作成する
単純な修正を行っていて、他のデベロッパーとコラボレーションしていない場合は、通常、個人用ブランチが作業に適しています。個人用のブランチを使用してすばやく更新を行い、変更を commit して本番環境に push できます。
ただし、個人用ブランチに加えて、新しい Git ブランチを作成することが必要になる場合もあります。次のような場合には新しい Git ブランチが有効です。
- 他のデベロッパーとコラボレーションしている。個人用ブランチは他のデベロッパーには読み取り専用で、他のデベロッパーとコラボレーションする場合は、他のデベロッパーがブランチに書き込めるように新しい Git ブランチを作成する必要があります。他のユーザーと共同編集している場合は、作業を再開するたびに変更を pull するようにしてください。これにより、作業を続行する前に、すべてのデベロッパーからの最新情報を確認できます。
- 一度に複数の機能セットを扱う。 大きなプロジェクトの最中に、軽微な問題を解決したり、すぐに修正したりする必要がある場合があります。この場合、表示しているブランチに変更を commit してから、別のブランチを作成するか、別のブランチに切り替えて別の機能セットで作業できます。新しいブランチで問題を修正し、そのブランチの変更を本番環境にデプロイしてから、元のブランチで作業を再開できます。
新しいブランチを作成する前に:
- 現在のブランチでマージの競合が発生している場合は、新しいブランチを作成する前に競合を解決する必要があります。
- 現在のブランチで commit されていない変更がある場合は、新しいブランチを作成する前に、現在のブランチで変更を commit する必要があります。
- （本番環境ブランチではなく）既存の開発ブランチからブランチを作成する場合は、まずその開発ブランチに切り替えて、開発ブランチの最新バージョンを取得してから、リモート変更を pull して、そのブランチのローカル バージョンを同期します。
新しい Git ブランチを作成するには:
- Development Mode がオンになっていることを確認します。
[Develop] メニューでプロジェクト ファイルに移動します。
左側のアイコン メニューで Git アイコンを選択し、[Git Actions] パネルを開きます。
[View Branches] プルダウン メニューを選択します。
[New Branch] を選択します。
[新しいブランチ] ウィンドウで、ブランチの名前を入力します。Git ブランチ名には制限があります。命名要件については、このページのGit ブランチの命名規則をご覧ください。
[Create From] プルダウン メニューを選択し、新しいブランチの出発点として使用する既存のブランチを選択します。
[作成] を選択してブランチを作成します。
また、プロジェクトの設定の [ブランチ管理] タブから Git ブランチを作成することもできます。
Git ブランチの命名規則
Looker は Git で指定されたブランチ命名規則の要件を使用します。
Git ブランチ名は次のことはできません。
- スペース文字を含める
- ダブルピリオドを含む:
.. - バックスラッシュを含む:
\ - シーケンスを含む:
@{ - 疑問符を含む:
? - 左角かっこを含む:
[ - ASCII 制御文字のいずれかを含む:
~、\^、: - ピリオドで始まる:
. - 接頭辞
dev-で始まる（Looker デベロッパーの個人ブランチ用に予約されている） - スラッシュで終わる:
/ - 次の拡張子で終わる:
.lock
さらに、ブランチ名にはアスタリスク（*）のみを使用できます。アスタリスクがパス コンポーネント全体（例: foo/* または bar/*/baz）を表している場合、ワイルドカードとして解釈されます。実際のブランチ名の一部ではありません。
別の Git ブランチに切り替える
現在のブランチでマージの競合が発生している場合は、別のブランチに切り替える前に競合を解決する必要があります。
また、現在のブランチで commit されていない変更がある場合、現在のブランチでその変更を commit するまで、既存のブランチに切り替えることはできません。
別の Git ブランチに切り替える手順は次のとおりです。
- 左側のアイコン メニューで Git アイコンを選択して、[Git Actions] パネルに移動します。
- [Git アクション] パネルで、現在の Git ブランチ名の右側にある Git ブランチのプルダウン メニューを選択します。
- メニューからブランチを選択するか、検索ボックスにブランチ名を入力して、切り替え先のブランチを選択します。ブランチ名の検索では大文字と小文字が区別されません。たとえば、「DEV」を検索すると、「dev」、「DEV」、「Dev」などを含む名前を持つすべてのブランチを表示できます。
Git ブランチの管理
プロジェクトの設定ページの [ブランチ管理] タブに、Looker プロジェクトのすべての Git ブランチのテーブルが表示されます。[ブランチ管理] タブを開くには、まず左側のアイコン メニューから [設定] アイコンを選択してプロジェクトの設定に移動します。次に、[ブランチ管理] タブを選択します。