> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-ja/kdo/buranchi/buranchinodepuroi.md).

# ブランチのデプロイ

デプロイでは、ブランチのメタデータコンポーネントをターゲットの Salesforce 組織へ送ります。実際に変更を適用するため、コード/設定を Salesforce 環境へ移す最後のステップになります。

{% hint style="warning" %}

#### 旧UI向けに作成

この記事は旧UI向けに作成されました。手順は今でも使用できますが、スクリーンショットは古くなっています。場合によっては、手順で参照されている項目が移動または変更されていることがあります。項目が見つからない場合は、 [どこに行ったのか](/devops/devops-ja/shii-uiux-heno/dokonittanoka.md) 記事。
{% endhint %}

## ![](https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) 概要 <a href="#what-is-deploy" id="what-is-deploy"></a>

ブランチをデプロイすると、Cloud DevOpsブランチからDevOpsに接続されたSalesforce組織へメタデータコンポーネントを移行できます。

デプロイプロセスでは、次のことが保証されます。

* 選択したブランチコンポーネントが対象組織に適用される
* オプションの破壊的変更によって、不要になったメタデータを削除できる
* コンプライアンスと安定性のために、Apexテストとデプロイ後のステップが実行される

検証後にデプロイを実行することで、UATや本番環境などの上位環境へ安心して変更を昇格できます。

{% hint style="info" %}

#### 検証を推奨

デプロイ前に、デプロイ対象のブランチ、コンポーネント、組織を使用して検証ジョブを実行してください。続行する前に、検証が成功していることを確認してください。検証の詳細な手順については、次の記事を参照してください。

* [ブランチ Validate の使用](/devops/devops-ja/kdo/buranchi/buranchi-validate-no.md)
  {% endhint %}

{% hint style="info" %}

#### ベストプラクティス

* UATまたは本番環境へデプロイする前に、必ず検証してください。
* 使用 **デプロイ前** および **デプロイ後** の破壊的変更は慎重に使用し、項目を安全に削除できることを確認してください。
* 本番環境では、常に **すべてのテストを実行** または **ローカルテストを実行**を選択してください。下位環境では、 **テストを実行しない** を選択して、デプロイを高速化できます。
* 不要な上書きを回避するため、プロファイル/権限セットのスコープ設定を使用してください。
* デプロイ後にログを慎重に確認し、成功を確認してください。
* 活用 **ロールバック** 予期しない問題が発生した場合は、直ちに実行してください。
  {% endhint %}

## ブランチデプロイジョブを実行 <a href="#what-is-deploy" id="what-is-deploy"></a>

{% stepper %}
{% step %}

### ブランチを選択してデプロイを開始

1. クリック **コード** を左側のサイドバーメニューから選択します。
2. リストからブランチを選択します。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FowIktcJ0lJan93guER9t%2FDeployingABranch-S01-01.png?alt=media&amp;token=f7616efc-dc31-4e32-8058-2f7442b2a3bc" alt="" width="563"><figcaption></figcaption></figure></div>
3. クリック **デプロイ**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FLiqsWo46IYOcLuCpFV4x%2FDeployingABranch-S01-02.png?alt=media&amp;token=8b7f5be8-0723-4368-a454-8b60dcb0fa68" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### コンポーネントと組織を選択

1. クリック **追加** をクリックして、デプロイに含める各ブランチコンポーネントを追加します。
2. （任意）クリック **すべて追加** をクリックして、すべてのコンポーネントをデプロイに追加します。
3. クリック **次へ**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F7eUSGY5EsHqT9QrlGovD%2FDeployingABranch-S02-01.png?alt=media&amp;token=617ed586-6a1c-4e0e-b108-eb30fa302bb9" alt="" width="563"><figcaption></figcaption></figure></div>
4. クリック **選択** をクリックして、デプロイ先のSalesforce組織を選択します。
5. クリック **次へ**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FAlc0MmheCbhgNKE4O3Vg%2FDeployingABranch-S02-02.png?alt=media&amp;token=3b37fb89-529a-4d64-a8ba-0993c57d9ad8" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 破壊的変更を選択

コンポーネントには、次のマークを付けることができます。 **デプロイ前** （デプロイ前に削除）または **デプロイ後** （デプロイ後に削除）。

{% hint style="info" %}
デフォルトでは、すべてのデプロイ前およびデプロイ後の破壊的変更が追加されます。
{% endhint %}

1. （任意）デプロイから破壊的変更を削除するには、 **追加済み** をクリックしてコンポーネントの選択を解除します。
2. クリック **次へ**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FQTU0IdJnsWal0GEGCN7t%2FDeployingABranch-S03-01.png?alt=media&amp;token=7caefd43-6e5d-4610-ae88-d2bfb4c7f84e" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### デプロイを設定して実行

1. 次をクリックします： **テストを実行** ドロップダウンメニューで、実行するApexテストのレベルを選択します。各項目の説明については、以下の表を参照してください。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FGQysHY6ruIWKtmgsZFny%2FDeployingABranch-S04-01.png?alt=media&amp;token=39805d95-dd36-4aa7-b763-1ff557316615" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="180.333251953125">テストレベル</th><th>説明</th></tr></thead><tbody><tr><td><strong>デフォルト</strong></td><td>パッケージに含まれるテストのみを実行します。</td></tr><tr><td><strong>テストを実行しない</strong></td><td>すべてのApexテストをスキップします（本番以外の組織でのみ許可されます）。</td></tr><tr><td><strong>ローカルテストを実行</strong></td><td>インストール済みの管理パッケージのテストを除く、組織内のすべてのテストを実行します。</td></tr><tr><td><strong>すべてのテストを実行</strong></td><td>管理パッケージのテストを含む、組織内のすべてのテストを実行します。</td></tr><tr><td><strong>関連テストを実行</strong></td><td>選択したコンポーネントとその依存関係に関連するテストのみを実行します。このオプションは、Salesforce の RunRelevantTests 機能を使用して、実行するテストを自動的に判定します。詳細については、 <a href="https://help.salesforce.com/s/articleView?id=release-notes.rn_apex_run_relevant_tests.htm&#x26;release=260&#x26;type=5">Salesforceヘルプ</a>.</td></tr><tr><td><strong>指定したテストを実行</strong></td><td>実行する個別のテストクラスまたはメソッドを指定できます。</td></tr></tbody></table>

2. デプロイ設定のトグルをクリックして設定を有効にします。各設定の説明については、次の表を参照してください。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FFFbssDZs5otsVf3UygrV%2FDeployingABranch-S04-02.png?alt=media&amp;token=c977ae4a-d791-465f-a4ee-c1d122db2bdc" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="299.6666259765625">設定</th><th>説明</th></tr></thead><tbody><tr><td><strong>選択したコンポーネントのプロファイル設定のみをデプロイ</strong></td><td>検証のみ <strong>プロファイル設定</strong> この検証ジョブに含めるよう選択したコンポーネントに対してのみ実行します。</td></tr><tr><td><strong>選択したコンポーネントの権限セット設定のみをデプロイ</strong></td><td>検証のみ <strong>権限セット設定</strong> この検証ジョブに含めるよう選択したコンポーネントに対してのみ実行します。</td></tr><tr><td><strong>デプロイ後のApexコードを実行</strong></td><td>デプロイの完了後に定義済みのApexスクリプトを実行します。有効にすると、スクリプトを入力するためのテキストボックスが表示されます。</td></tr><tr><td><strong>デプロイ時の警告を無視</strong></td><td>警告があってもデプロイを続行できます。</td></tr><tr><td><strong>Vlocity LWCの有効化</strong></td><td>有効にすると、Vlocity Lightning Webコンポーネントがデプロイ中に自動的に有効化、コンパイルされ、実行可能になります。</td></tr></tbody></table>

3. クリック **実行** をクリックして、デプロイジョブを開始します。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FJWKAGbdxEem2eTAUKLFw%2FDeployingABranch-S04-03.png?alt=media&amp;token=f5473c0f-1236-4b51-a9f2-5aba6643d1d1" alt="" width="563"><figcaption></figcaption></figure></div>
4. デプロイジョブを開始すると、次の場所に表示されます： **アクティビティ** タブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F2t5B8UnapxQDMhJHOCAc%2FDeployingABranch-S04-04.png?alt=media&amp;token=5e4bbcd3-111d-47ea-ac00-4d79d3d6de25" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 進行中のデプロイ

進行中の **デプロイ** ジョブが **進行中**の場合、ステータスを監視し、必要に応じてキャンセルできます。

1. 次をクリックします： **進行中** デプロイジョブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FxwAKoWsgFqvMNpzdvX9P%2FDeployingABranch-S05-01.png?alt=media&amp;token=94441191-4fc7-4e4b-b025-562c584e240e" alt="" width="563"><figcaption></figcaption></figure></div>

**ログを更新**

1. クリック **更新** をクリックして、現在のログでログビューを更新します。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FtigTi8i0cyADr8dzA4JC%2FDeployingABranch-S05-02.png?alt=media&amp;token=51671cde-00be-40e3-91e7-8226ac504bd2" alt="" width="563"><figcaption></figcaption></figure></div>

**デプロイを中止**

1. クリック **中止**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FgRQtNO4iGhNYpmjn7ei9%2FDeployingABranch-S05-03.png?alt=media&amp;token=d34877fa-20f7-4732-b2cf-24292bef577a" alt="" width="563"><figcaption></figcaption></figure></div>
2. クリック **中止** で **デプロイを中止** 確認ダイアログ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F5f9vAiKB3r1OFyBfZkzS%2FDeployingABranch-S05-04.png?alt=media&amp;token=af38967f-6db5-46be-8ac5-d478e4afc07d" alt="" width="375"><figcaption></figcaption></figure></div>
3. デプロイジョブは停止し、Salesforce組織に対してそれ以上のアクションは実行されません。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FAG5y8QoNWB97veoy9riv%2FDeployingABranch-S05-05.png?alt=media&amp;token=d5ecf009-3e63-4274-a00b-20dd51401ea0" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}

## デプロイ結果 <a href="#what-is-deploy" id="what-is-deploy"></a>

{% stepper %}
{% step %}

### 結果を表示

1. 次をクリックします： **アクティビティ** タブ。
2. 次を確認します： **デプロイ** ジョブステータスが **完了**.

{% hint style="info" %}
デプロイジョブ中にエラーが発生すると、ステータスは次に変わります： **例外**。デプロイジョブのログを確認してエラーを特定してください。
{% endhint %}

<table><thead><tr><th width="159.6666259765625">ジョブのステータス</th><th>説明</th></tr></thead><tbody><tr><td><strong>キューに入っています</strong></td><td>ジョブが作成され、実行待ちです。</td></tr><tr><td><strong>進行中</strong></td><td>ジョブは実行中です。</td></tr><tr><td><strong>完了</strong></td><td>ジョブは正常に完了しました。</td></tr><tr><td><strong>例外</strong></td><td>ジョブはエラーとともに完了しました。</td></tr></tbody></table>

3. 次をクリックします： **デプロイ** ジョブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FmF98PxJFeGMb0bvk5Zq3%2FDeployingABranch-Results-S01-01.png?alt=media&amp;token=5640c5d7-4797-4066-829c-5f53b7f47540" alt="" width="563"><figcaption></figcaption></figure></div>
4. この **デプロイ** 結果ページには、ジョブ情報と詳細なログが表示されます。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F1rZSpL23RCv6D75yO9Uc%2FDeployingABranch-Results-S01-02.png?alt=media&amp;token=10af3e1e-e9c0-46d0-8079-165e821afa3e" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### ログを確認（エラーなし）

デプロイジョブのログには、次の詳細が含まれます。

* 破壊的変更オブジェクトの有無。
* デプロイされたコンポーネントの数と一覧。
* Apexテスト実行の種類と結果。
* 完了したデプロイ手順。

<div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FmAcSWTgxb5kUxVfvgUZu%2FDeployingABranch-Results-S02-01.png?alt=media&amp;token=360bb5c6-704f-4ca8-a174-10b7422663f1" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### ログを確認（エラーあり）

デプロイジョブでエラーが発生した場合は、ログを調べて原因を特定します。次のマークが付いたエントリに注目してください： **\[error]**。以下のスクリーンショットは、ブランチで必要な複数のコンポーネントがSalesforce組織に不足している状態で実行されたデプロイジョブを示しています。

<div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG1J7gVdeoXGGRbQp9U2N%2FDeployingABranch-Results-S03-01.png?alt=media&amp;token=f4a8c53f-82bb-4e2c-9ec9-fd04891d8204" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FgG1QeRxJzyXlChyku2Ve%2FDeployingABranch-Results-S03-02.png?alt=media&amp;token=eaf8bbfe-4c31-4dc0-acb6-73a6ca631fd9" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FzZCAyoz3OP53Ds2iskjS%2FDeployingABranch-Results-S03-03.png?alt=media&amp;token=1b4cc530-e158-4b96-b29c-7fd05208be08" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### デプロイをロールバック

デプロイ結果ページでバックアップが作成されている場合は、 **ロールバック** ボタンが表示されます。［ロールバック］をクリックすると、バックアップスナップショットを使用して、組織をデプロイ前の状態に復元します。このプロセスの詳細な手順については、次の記事を参照してください。

* [デプロイのロールバック](/devops/devops-ja/kdo/buranchi/depuroinorrubakku.md)
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/devops/devops-ja/kdo/buranchi/buranchinodepuroi.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
