ブランチの操作

Amplitude データのブランチとは、あなたとあなたのチームがプライベートに編集できるトラッキングプランのポイントインタイムコピーです。メインのトラッキングプランにマージするまで、変更内容は他の誰にも公開されません。Git を使用している場合も、このモデルは同じように動作します。ブランチ上の変更を分離し、準備が整ったらそれらをマージします。

Amplitude データアカウントを最初に作成すると、Amplitudeは自動的に「main」mainというデフォルトのブランチを作成します。これには、使用を開始するためのいくつかのサンプルイベントとプロパティが含まれています。ブランmainチを本番ブランチとみなしてください。このブランチには最新の公式な追跡計画が含まれており、Git のデフォルトブランチ (通常は masterまたは main) で計測されているものと一致します。

main「main」はAmplitude データの利用を開始するのに適しており、しばらくの間はこれだけで十分な場合もあります。

トラッキングプランのバージョンを公開する

ブランチは最初、ユーザーが行った変更をステージングエリアに保存し、そこで変更は保留のままになります。 保留中の変更は作業中の変更です。つまり、あなたやチームメイトには見えますが、運用システムからは隠されており、エンジニアリングチームによる計装にはまだ使用できません。

保留中の変更の準備が整ったら、それらを公開してください。 変更を公開すると、それらの変更を含むトラッキングプランの新しいバージョンが作成されます。 また、公開することで、その新しいバージョンがエンジニアリングチームに公開され、計装作業も行えます。 新しいバージョンがメインブランチにある場合、これらの変更は本番システムにも反映されます。

すべての新しいバージョンにはバージョン番号とオプションの説明が付いているため、後でバージョンを区別できます。 バージョン番号は1から始まり、新しいバージョンを公開するたびに、1ずつ増えます。

各ブランチには独自のトラッキングプランバージョンがあります。つまり、同じバージョン番号を持つトラッキングプランのバージョンを 2 つ用意できる可能性があります。1 つは main に、もう 1 つは自分のブランチに存在します。この場合、混乱を避けるためにAmplitude データは常にブランチの名前を表示します。

ブランチの作成と削除

あなたとあなたのチームがAmplitudeデータを利用する機会が増えるにつれて、mainブランチの規模が拡大し、より堅牢なワークフローが必要になる可能性があります。これは通常、次の場合に発生します。

• あまりにも多くのユーザーが同時に mainに変更を加えている、または
• 各フィーチャーチームが、共同作業、作業のレビュー、ステークホルダーの承認のために、トラッキングプランの独自のコピーを必要としている。

Amplitudeデータでは、すべてのブランチが mainから生成され、再び main にマージされます。

新しいブランチを作成するには、以下の手順に従ってください。

1. ページのヘッダーにある [メイン] をクリックします。

2. 作成したいブランチの名前を入力します。

3. [+] をクリックします。

4. 「ブランチを作成」モーダルで、ブランチの名前を確認し、オプションで説明を追加してから、「作成」をクリックします。

   mainに保留中の変更がある場合は、それらの変更を新しいブランチに持ち込むか、main に残しておくことができます。

ブランチを削除するには、次の手順に従ってください。

1. ブランチ名の横にある X をクリックします。
2. 表示されるモーダルで、［Delete］ をクリックして選択内容を確認します。

ブランチでの作業

ブランチが存在した後は、ブランチでの作業は main での作業と同じです。 あなたとあなたのチームは、新しいバージョンを作成して公開し、プロダクト内でそれらのバージョンを計測し、計測のステータスについてブランチにレポートすることができます。

これはすべて、独自のブランチで作業している他のチームと並行して行うことができ、あなたへの影響はありません。

ブランチを作成してmainから行われた変更を反映して、ブランチを随時更新してください。 Amplitude Dataがブランチが古いことを検出した場合main、ページのツールバーに「更新」ボタンが表示されます。それをクリックすると、追いつくことができます。

ブランチをメインに再度マージする

ブランチに加えた変更に満足したら、それらを main にマージし直してください。 これは通常、プロダクトチームも変更を Git のmainブランチにマージする準備ができている場合に発生します。

マージを正常に実行するには、いくつかの前提条件に対処する必要があります。

• 保留中の変更はすべてブランチで公開する必要があります。
• ブランチは main を最新の状態に保っている必要があります。
• main 保留中の変更もすべて公開する必要があります。

ブランチで変更内容を新しいバージョンに公開するには、以下の手順に従ってください。

1. 左側のサイドバーで、「変更を保存」をクリックします。
2. [変更を保存] モーダルで、保留中の変更を確認します。すべてが正しく表示されたら、[保存] をクリックします。

マージするには、次の手順に従ってください。

1. アクティビティへ移動します。 ［Refresh］をクリックする必要がある場合があります。
2. [承認] をクリックします。
3. [マージ] をクリックします。

プロジェクトにチームレビューが必要な場合は、直接マージする権限がない可能性があります。 この場合、まずマージ要求を作成する必要があります。 マージリクエストとは、チーム以外の関係者に変更内容を確認してもらい、明示的に承認してもらうための方法です。 マネージャーまたは管理者の権限を持つチームメンバーのみが変更を承認できます。これを行うには、Amplitude データにログインし、ページのツールバーで**[マージ]**をクリックします。

その後、チームの誰でも承認されたマージリクエストをマージできます。

ブランチの変更をテスト環境にコピーする

ブランチに変更を適用した後、テスト用にそれらの変更を他のプロジェクトや環境にコピーできます。

ブランチの変更をコピーするには、次の手順に従ってください。

1. コピーしたいブランチから*「アクティビティ」>「ブランチ変更」*に移動します。
2. **[ブランチをコピー] **をクリックします。
3. 表示されるモーダルで、ドロップダウンからブランチをコピーするテストプロジェクトを選択します。 次に、[コピー] をクリックします。
4. コピーが完了したら、通知をクリックしてコピーされたブランチを確認します。
5. テストプロジェクトへの変更を確認します。 変更内容が予想どおりであれば、[マージ] をクリックします。

マネージャーと管理者は、ブランチ変更のコピーを受け入れることができるプロジェクトを制限することもできます。

ブランチコピーを制限するには、次の手順に従ってください。

1. ソースプロジェクトから、「*設定」>「一般」*に移動します。
2. 「ブランチコピーを指定したテストプロジェクトに制限する」の横にあるチェックボックスを選択します。
3. ドロップダウンから、他のAmplitudeユーザーがブランチ変更のコピーを保存できるプロジェクトの横にあるチェックボックスを選択します。