> ## 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.

# Custom Script를 사용하여 Homebrew 배포

> Iru Endpoint에서 Custom Script를 사용하여 관리되는 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 개요](/ko/endpoint/library/library-items-profiles/library-overview) 문서에 설명된 단계를 따르십시오.

Library Item 이름 지정, Blueprint 할당, 실행 빈도 및 Self Service와 같은 개괄적인 Custom Script 옵션에 대해서는 [Custom Scripts 개요](/ko/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_install.zsh`가 수정 스크립트인 경우를 포함하여 Homebrew가 있어야 하는 경우 `"installed"`를 사용합니다. Homebrew가 없어야 하는 감사 전용 Library Item에만 `"not_installed"`를 사용합니다.

<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>