> 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/buranchi-predeploy-fix-no.md).

# ブランチ PreDeploy Fix の使用

PreDeploy Fix は、デプロイ前に不足している依存関係を事前に検出し、解決します。

{% 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-pre-deploy-fix" id="what-is-pre-deploy-fix"></a>

PreDeploy Fix は、デプロイ前にブランチを潜在的な問題がないか検証するプロセスです。たとえば次のようなものです:

* API バージョンの不一致
* 不足しているコンポーネント
* 壊れた参照
* 満たされていない依存関係

問題が検出されると、解決方法のオプションとともに一覧表示されます。このプロセスは、次の方法でデプロイ失敗を防ぐのに役立ちます:

* コンポーネントの API バージョンを確認して更新する
* 不足しているメタデータを取得する
* 問題のあるコンポーネントへの参照を削除または更新する

これらの点に対処することで、デプロイはよりクリーンになり、エラーが起こりにくくなります。

{% hint style="info" %}

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

* PreDeploy Fix は必ず次の前に実行してください **検証** または **デプロイ** して、失敗の可能性を減らしてください。
* 不足している依存関係については、可能な場合は **取得** すべての依存関係が正しく含まれるように、可能な場合は **削除** を使用してください。参照が廃止済みである、または不要であると確信できる場合にのみ使用してください。
* 明確で説明的な **コミットメッセージ**を入力してください。これらは今後の追跡のために Commits タブに表示されます。
* 問題が解決するまで、PreDeploy Fix を再実行して一覧が空になることを確認してください。
* のフィルター（ステータス、タイプ、日付範囲）を使用して **アクティビティ** で PreDeploy Fix ジョブをすばやく追跡できます。
* ジョブが次の状態で終了したら、必ずログを確認してください **例外** または **対応が必要** 。何を修正する必要があるかを把握するためです。
  {% endhint %}

## ブランチ PreDeploy Fix を実行

{% stepper %}
{% step %}

### ブランチを選択して PreDeploy Fix を実行

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%2FIdXYUvm5XLcLpFf6tcmj%2FUsingBranchPreDeployFix-Run-S01-01.png?alt=media&amp;token=01c96a94-bea4-436c-8ea9-ec2d50cafdc3" alt="" width="563"><figcaption></figcaption></figure></div>
3. 次をクリックします **縦三点 ⋮** のドロップダウンメニューをデプロイの横で開きます。
4. 次をクリックします **PreDeploy Fix**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FyZQGxPQ2giKszNeEoLZz%2FUsingBranchPreDeployFix-Run-S01-02.png?alt=media&amp;token=ce3fa710-e4f3-4a08-86ec-2549ec71b9cc" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 接続を選択

1. 次をクリックします **次を選択** PreDeploy Fix を実行する Salesforce 組織の接続として。
2. 次をクリックします **実行**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F05kTXmCyb3gJFyf6XHvH%2FUsingBranchPreDeployFix-Run-S02-01.png?alt=media&amp;token=7f3a254f-8dee-407b-80d2-8d1a60bda1f4" alt="" width="563"><figcaption></figcaption></figure></div>
3. PreDeploy Fix ジョブを開始すると、次の **アクティビティ** タブに表示されます。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FbBmP8aYsJIm2wFEw1Pw2%2FUsingBranchPreDeployFix-Run-S02-02.png?alt=media&amp;token=2deceaf0-3683-46a6-9944-ea555dec97ce" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}

## PreDeploy Fix の結果

{% stepper %}
{% step %}

### 結果を表示

1. 次をクリックします **アクティビティ** タブに表示されます。
2. 次を確認してください **Pre Deploy Fix 検索** ジョブのステータスが **完了**.
3. 次をクリックします **Pre Deploy Fix 検索** のジョブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FkX5Xq80oRHqu2y646gL5%2FUsingBranchPreDeployFix-Results-S01-01.png?alt=media&amp;token=c65551d2-e419-4437-9f82-21b6c22d71d9" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
PreDeploy Fix ジョブを見つけやすくするには、次をクリックできます **すべてのタイプ** のドロップダウンフィルターメニューをクリックして、次を選択します **Pre Deploy Fix 検索**。これによりジョブがフィルタリングされ、PreDeploy Fix ジョブのみが表示されます。
{% endhint %}
{% endstep %}

{% step %}

### API バージョン エラー

PreDeploy Fix が API バージョン エラーを検出した場合、それらは次の **API バージョン エラー** テーブルに表示されます。このテーブルには、API バージョン エラーのある各コンポーネントが表示されます。各コンポーネントの右側には 2 つの API バージョンがあります。 **コンポーネントの API バージョン** および **組織の API バージョン**。コンポーネントの API バージョンはブランチ内でそのコンポーネントが使用しているバージョンであり、組織の API バージョンは、この PreDeploy Fix の接続として使用された Salesforce 組織でそのコンポーネントが使用しているバージョンです。

{% hint style="info" %}
次の [#fixing-api-version-errors](#fixing-api-version-errors "mention") セクションを参照して、これらのエラーの解決方法を確認してください。
{% endhint %}

1. 次をクリックします **API バージョン エラー** タブに表示されます。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FT2tzIFIHBtVK2cIbB6HM%2FUsingBranchPreDeployFix-Results-S02-01.png?alt=media&amp;token=c089c611-bba4-483a-bbea-370c63710fd5" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 不足している依存関係

PreDeploy Fix が不足している依存関係を検出した場合、それらは次の **不足しているコンポーネント** テーブルに表示されます。このテーブルには、各不足メタデータ依存関係と、それを参照しているコンポーネントが表示されます。不足しているコンポーネントを修正するには、2 つのオプションから選び、必要に応じて各コンポーネントに適用できます。

* **取得**：このオプションは不足しているコンポーネントを取得し、ブランチにコミットします。
* **削除**：このオプションは不足しているコンポーネントへの参照を削除します。ブランチ内にそのコンポーネントがなくてもデプロイして安全であることが確認できた場合にのみ使用してください。

{% hint style="info" %}
次の [#fixing-missing-dependencies](#fixing-missing-dependencies "mention") セクションを参照して、これらのエラーの解決方法を確認してください。
{% endhint %}

1. 次をクリックします **不足している依存関係** タブに表示されます。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Fsxar16N8F4WVrEI0LuLp%2FUsingBranchPreDeployFix-Results-S03-01.png?alt=media&amp;token=9de33d26-0e70-4639-b90e-d95b35b72f3b" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
次の場合 **不足している依存関係** タブが表示されていない場合は、不足している依存関係がないことを意味します。
{% endhint %}
{% endstep %}

{% step %}

### ジョブログを表示

PreDeploy Fix ジョブのログを表示して、処理上の問題がないか確認し、どの Salesforce 組織でジョブが実行されたかを確認できます。

1. 次をクリックします **ログを見る**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Fn19GHg6TGXteRfXS7HNN%2FUsingBranchPreDeployFix-Results-S04-01.png?alt=media&amp;token=2e779c7f-3131-41fd-be81-b9305e2fe396" 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%2FgGZKr0EVgPXTOY5NrXIT%2FUsingBranchPreDeployFix-Results-S04-02.png?alt=media&amp;token=e18bee54-326d-4d0a-9b1a-4b1ab7bf2876" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### PreDeploy Fix を再実行

すべての API バージョン エラーを修正し、不足している依存関係を解決したら、PreDeploy Fix ジョブを再実行して、問題が残っていないことを確認してください。次のスクリーンショットは、問題を検出せずに完了した PreDeploy Fix ジョブを示しています。

{% hint style="info" %}
両方の **API バージョン エラー** および **不足している依存関係** テーブルには **コンポーネントなし**.
{% endhint %}

<div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FS7XwTpQMn4qCwNwHYpj7%2FUsingBranchPreDeployFix-Results-S05-01.png?alt=media&amp;token=198ee8ad-59a8-4748-8c54-0051d8201314" 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%2FtM7SSbDb6s1dJlSWf1Qc%2FUsingBranchPreDeployFix-Results-S05-02.png?alt=media&amp;token=ca61062b-6a8d-491b-89e9-31539de1eda6" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## API バージョン エラーの修正

次の場合 **PreDeploy Fix** が API バージョン エラーを検出した場合は、正しいバージョンに更新することで修正できます。

{% stepper %}
{% 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%2FwiQQdrxA7JLiKNb8L1JV%2FUsingBranchPreDeployFix-FixApi-S01-01.png?alt=media&amp;token=f57ef69d-9551-43c6-a842-c1bf93651ca8" alt="" width="563"><figcaption></figcaption></figure></div>
2. 次をクリックします **追加** 各コンポーネントに対して API バージョンを更新します。
3. 次をクリックします **更新**.

   <figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FYtuA2eLPxFlQ2EAJY4dq%2FUsingBranchPreDeployFix-FixApi-S01-03.png?alt=media&amp;token=9d31504a-4e6c-40bb-a52f-ff5f65e73faa" alt=""><figcaption></figcaption></figure>
4. 次を入力します **コミットメッセージ** をブランチへの変更内容として。
5. 次をクリックします **解決**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FF204Q8cCkakXhf0m6W1A%2FUsingBranchPreDeployFix-FixApi-S01-04.png?alt=media&amp;token=423e3c23-acab-4c8a-9bf0-4491ec6920af" alt="" width="375"><figcaption></figcaption></figure></div>
6. API 更新ジョブを開始すると、次の **アクティビティ** タブに次として表示されます **Pre Deploy Fix 更新** のジョブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FiBgaxF648pRfnbM7R9MV%2FUsingBranchPreDeployFix-FixApi-S01-05.png?alt=media&amp;token=6eb9e099-a1b6-45ba-9468-2f1265d1506b" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 結果を表示

1. 次をクリックします **Pre Deploy Fix 更新** のジョブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FdDfB3NWTfIShA3zqVFru%2FUsingBranchPreDeployFix-FixApi-S02-01.png?alt=media&amp;token=7d68a13c-eaf7-4f5c-970b-c3d4b1ee6ecf" 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%2FSfnewHUnqewx2KpT1CSB%2FUsingBranchPreDeployFix-FixApi-S02-02.png?alt=media&amp;token=9720194c-e344-49bc-9a63-ef9fbbee4600" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}

## 不足している依存関係の修正

{% stepper %}
{% step %}

### 不足しているコンポーネントを取得

選択したメタデータはブランチに取得され、コミットとして追加されます。

{% hint style="info" %}
すでに依存コンポーネントを削除済みの場合は、取得対象として選択しないでください。不明な場合は、PreDeploy Fix ジョブを再実行できます。
{% endhint %}

1. 次をクリックします **取得**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FYuM2vmvvGneahAJUyvSG%2FUsingBranchPreDeployFix-FixDependencies-S01-01.png?alt=media&amp;token=ee4ed48a-21d4-42da-aafd-21a42161e5c4" alt="" width="563"><figcaption></figcaption></figure></div>
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%2FaxDdQ5jmbn60BpyHg9wW%2FUsingBranchPreDeployFix-FixDependencies-S01-02.png?alt=media&amp;token=43087ae8-a4e4-4ec9-add9-baaf69d05d54" alt="" width="563"><figcaption></figcaption></figure></div>
4. 次を入力します **コミットメッセージ** をブランチへの変更内容として。
5. 次をクリックします **接続** のドロップダウンメニュー。
6. 依存コンポーネントを取得する Salesforce 組織を選択します。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F6j7Jy9oG1afqswNQqGP9%2FUsingBranchPreDeployFix-FixDependencies-S01-03.png?alt=media&amp;token=001af173-ac54-4ee7-9658-d9ac9020b959" alt="" width="375"><figcaption></figcaption></figure></div>
7. 次をクリックします **実行**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FWYSXXvBV2yuLDWQ5r9C5%2FUsingBranchPreDeployFix-FixDependencies-S01-04.png?alt=media&amp;token=20d910d5-7853-430e-ac3a-37db146c40f1" alt="" width="375"><figcaption></figcaption></figure></div>
8. 不足している依存関係の取得ジョブを開始すると、次の **アクティビティ** タブに次として表示されます **Pre Deploy Fix 更新** のジョブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FXOS5YOEA1DZt8lQa6yiV%2FUsingBranchPreDeployFix-FixDependencies-S01-05.png?alt=media&amp;token=6274c5dc-7e93-4915-a5e0-a882e64cd446" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 不足しているコンポーネントを削除

それらのコンポーネントへの参照はブランチから削除され、デプロイエラーを防ぎます。

{% hint style="info" %}
すでに依存コンポーネントを取得済みの場合は、削除対象として選択しないでください。不明な場合は、PreDeploy Fix ジョブを再実行できます。
{% endhint %}

1. 次をクリックします **削除**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FXmrpakqzi9tV3C9AG3JW%2FUsingBranchPreDeployFix-FixDependencies-S02-01.png?alt=media&amp;token=79c35740-90dc-4160-8edb-94e4ee092f04" alt="" width="563"><figcaption></figcaption></figure></div>
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%2FKZtd4vV9bplG3HYLZH8F%2FUsingBranchPreDeployFix-FixDependencies-S02-02.png?alt=media&amp;token=f111d15b-6ed2-482c-958d-e5cf0cad3497" alt="" width="563"><figcaption></figcaption></figure></div>
4. 次を入力します **コミットメッセージ** をブランチへの変更内容として。
5. 次をクリックします **実行**.

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FPKkvs133iu1bB9CfXgkx%2FUsingBranchPreDeployFix-FixDependencies-S02-03.png?alt=media&amp;token=c96ea6f0-5923-453e-b230-3ad9d709d8f5" alt="" width="375"><figcaption></figcaption></figure></div>
6. 不足している依存関係の削除ジョブを開始すると、次の **アクティビティ** タブに次として表示されます **Pre Deploy Fix 削除** のジョブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FRZgjNe19h5WVbQa5gdMn%2FUsingBranchPreDeployFix-FixDependencies-S02-04.png?alt=media&amp;token=9417ffa3-dfa8-4440-b206-fb7da16fa0c0" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 結果を表示

1. 次をクリックします **Pre Deploy Fix 取得** コンポーネントを取得するジョブ、または **Pre Deploy Fix 削除** コンポーネントを削除するジョブ。

   <div align="left"><figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FAYm7uKM0p9fB5llutifJ%2FUsingBranchPreDeployFix-FixDependencies-S03-01.png?alt=media&amp;token=5a582b94-295d-4c23-8233-95fa725f7a3b" 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%2Fk9cLwGh6oI7KcTCMb0TN%2FUsingBranchPreDeployFix-FixDependencies-S03-02.png?alt=media&amp;token=574cca9b-c7e1-4eda-9cfa-1d693c13720a" alt="" width="563"><figcaption></figcaption></figure></div>

{% 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/buranchi-predeploy-fix-no.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.
