> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# カスタムスクリプトを使用して Homebrew を展開する

> Iru Endpoint のカスタムスクリプトを使用して、管理対象の Mac コンピュータに Homebrew をインストールします。開発者ツールやユーティリティ向けのパッケージマネージャの展開を自動化します。

<Callout icon="apple" color="#B84A7A" iconType="regular">このガイドは Mac コンピュータに適用されます</Callout>

### Homebrew とは

Homebrew は、ソフトウェアのインストールを簡素化する macOS 向けの無料のオープンソースパッケージ管理システムです。使いやすさと豊富なパッケージにより、開発者やシステム管理者の間で人気のあるツールとなっています。

<Note>
  すべてのスクリプトと同様に、本番環境の Mac コンピュータに展開する前に十分にテストしてください。
</Note>

### Homebrew の仕組み

Homebrew はコマンドラインインターフェイス(CLI)と統合されており、ローカル管理者が CLI を使用して必要なソフトウェアをインストールできます。このツールは、ライブラリやツールを効率的にインストールする必要がある開発者やシステム管理者に便利です。

[`homebrew_audit.zsh`](https://github.com/kandji-inc/support/blob/main/Scripts/homebrew/homebrew_audit.zsh) は Homebrew がインストールされているかどうかを確認します。[`homebrew_install.zsh`](https://github.com/kandji-inc/support/blob/main/Scripts/homebrew/homebrew_install.zsh) は最新の安定版 Homebrew をインストールします。どちらかのスクリプトを単独で展開することも、監査が合格しない場合にインストールスクリプトが実行されるように両方を組み合わせて使用することもできます。

### 前提条件

* Iru Endpoint サポートの GitHub リポジトリから [`homebrew_audit.zsh`](https://github.com/kandji-inc/support/blob/main/Scripts/homebrew/homebrew_audit.zsh) をコピーします。
* 同じリポジトリから [`homebrew_install.zsh`](https://github.com/kandji-inc/support/blob/main/Scripts/homebrew/homebrew_install.zsh) をコピーします。
* テスト済みの macOS バージョン、インストール方法、監査オプション、スクリプトの動作については、[Homebrew スクリプトの README](https://github.com/kandji-inc/support/blob/main/Scripts/homebrew/README.md) を確認してください。

### Custom Script を追加する

この Library Item を Iru Endpoint Library に追加するには、[Library の概要](/ja/endpoint/library/library-items-profiles/library-overview)の記事に記載されている手順に従ってください。

Library Item の名前付け、Blueprint の割り当て、実行頻度、Self Service など、Custom Script の概要的なオプションについては、[Custom Scripts の概要](/ja/endpoint/library/library-items-profiles/custom-scripts-overview#add-a-custom-script-library-item)を参照してください。

### 監査スクリプトを構成する

[`homebrew_audit.zsh`](https://github.com/kandji-inc/support/blob/main/Scripts/homebrew/homebrew_audit.zsh) は、Homebrew がインストールされているかどうか、およびそのバージョンを読み取れるかどうかを報告します。Homebrew の監査のみを行う場合は、単独で展開します。監査で **エラー** が報告されたときに Homebrew をインストールするには、同じ Library Item にインストールスクリプトを修復スクリプトとして追加します。

`PASS_WHEN` の値は、Homebrew の想定される状態を決定します。Homebrew が存在する必要がある場合(`homebrew_install.zsh` が修復スクリプトである場合を含む)は `"installed"` を使用します。`"not_installed"` は、Homebrew が存在してはならない監査専用の Library Item でのみ使用します。

<Steps>
  <Step title="PASS_WHEN を設定する">
    `homebrew_install.zsh` が修復スクリプトである場合は、`homebrew_audit.zsh` で `PASS_WHEN` を `"installed"` に設定します。監査専用の Library Item では、Homebrew が存在する必要がある場合は `PASS_WHEN` を `"installed"` に、存在してはならない場合は `"not_installed"` に設定します。
  </Step>

  <Step title="監査スクリプトを追加する">
    スクリプトを **監査スクリプト** フィールドに貼り付けます。
  </Step>

  <Step title="構成を保存する">
    右下の **保存** を選択します。この Library Item で Homebrew の監査のみを行う場合は、ここで保存できます。
  </Step>
</Steps>

### インストールスクリプトを構成する

[`homebrew_install.zsh`](https://github.com/kandji-inc/support/blob/main/Scripts/homebrew/homebrew_install.zsh) は最新の安定版 Homebrew をインストールします。Homebrew のインストールのみを行う場合は、単独で展開します。監査スクリプトと組み合わせて使用する場合は、代わりにその Library Item に修復スクリプトとして追加します。監査で **エラー** が報告されると、Iru は修復スクリプトを実行します。

<Steps>
  <Step title="インストールスクリプトを追加する">
    Homebrew を単独でインストールするには、専用の Custom Script Library Item の **監査スクリプト** フィールドに `homebrew_install.zsh` を貼り付けます。監査で **エラー** が報告されたときに Homebrew をインストールするには、代わりに監査スクリプトの Library Item の **Remediation Script** フィールドに貼り付けます。
  </Step>

  <Step title="構成を保存する">
    右下の **保存** を選択して Custom Script のセットアップを完了します。
  </Step>
</Steps>