# Unity Gaming Services CLI

> Manage trigger configurations from the command line using the Unity Gaming Services command-line interface.

[Unity Gaming Services CLI](https://services.docs.unity.com/guides/ugs-cli/latest/general/overview)를 사용하여 트리거와 상호 작용할 수 있습니다. CLI를 사용하면 커맨드 라인에서 트리거 구성을 관리할 수 있습니다.

> **Note:**
>
> **참고**: CLI는 필터를 사용하는 트리거를 지원하지 않습니다. 필터를 사용하는 트리거를 생성하려면 [Triggers 관리자 API](./rest-api.md)나 [Unity Dashboard](./unity-dashboard.md)를 사용합니다.

## 필수 조건##prerequisites

CLI에 대한 보다 포괄적인 내용을 알아보려면 [Unity Gaming Services CLI 시작하기 가이드](https://services.docs.unity.com/guides/ugs-cli/latest/general/get-started/install-the-cli/)에 나와 있는 단계를 따르십시오.

이 가이드를 따르려면 먼저 다음 작업을 완료해야 합니다.

1. [UGS CLI를 설치합니다](https://services.docs.unity.com/guides/ugs-cli/latest/general/get-started/install-the-cli/).

2. 다음과 같이 프로젝트 ID와 환경을 구성합니다.
   `ugs config set project-id <your-project-id>`
   `ugs config set environment-name <your-environment-name>`

3. [Triggers](https://services.docs.unity.com/docs/service-account-auth/index.html#triggers-configuration-editor)와 [환경 관리](https://services.docs.unity.com/docs/service-account-auth/index.html#unity-environments-admin)에 필요한 역할을 사용하여 서비스 계정을 구성합니다. [인증 받기](https://services.docs.unity.com/guides/ugs-cli/latest/general/get-started/get-authenticated/)를 참고하십시오.

## CLI 사용##using-the-cli

모든 커맨드와 옵션에 대한 전체 레퍼런스가 필요한 경우, [Triggers 커맨드 라인 기술 자료](https://services.docs.unity.com/guides/ugs-cli/latest/triggers/Triggers%20Command%20Line/overview)를 참고하십시오.

> **Note:**
>
> **참고**: `ugs triggers` 커맨드는 `ugs tr`로도 사용할 수 있습니다.

### 트리거 배포##deploy-triggers

`new-file` 커맨드를 실행하여 로컬에서 트리거 구성을 생성할 수 있습니다.

```bash
ugs triggers new-file <file-name>
```

구성 파일 콘텐츠의 예시는 다음과 같습니다.

```json
{
  "$schema": "https://ugs-config-schemas.unity3d.com/v1/triggers.schema.json",
  "Configs": [
    {
      "Name": "example-trigger",
      "EventType": "com.unity.services.scheduler.{{EVENT_NAME}}.v{{EVENT_VERSION}}",
      "ActionUrn": "urn:ugs:cloud-code:MyScript",
      "ActionType": "cloud-code"
    }
  ]
}
```

여러 트리거를 포함하도록 구성 파일을 수정할 수도 있습니다.

```json
{
  "$schema": "https://ugs-config-schemas.unity3d.com/v1/triggers.schema.json",
  "Configs": [
    {
      "Name": "example-trigger",
      "EventType": "com.unity.services.scheduler.{{EVENT_NAME}}.v{{EVENT_VERSION}}",
      "ActionUrn": "urn:ugs:cloud-code:MyScript",
      "ActionType": "cloud-code"
    },
    {
      "Name": "example-trigger-2",
      "EventType": "com.unity.services.scheduler.{{EVENT_NAME}}.v{{EVENT_VERSION}}",
      "ActionUrn": "urn:ugs:cloud-code:MyScript",
      "ActionType": "cloud-code"
    }
  ]
}
```

`Deploy` 커맨드를 사용하면 로컬 트리거 구성 파일을 원격 환경으로 승격할 수 있습니다.

트리거가 활성화될 수 있도록 구성 파일을 배포해야 합니다.

```bash
ugs deploy <path-to-triggers-file> <path-to-triggers-file>
```

```bash
ugs deploy <path-to-directory>
```

트리거를 기존 Cloud Code 스크립트나 모듈과 연결한 경우, 지정된 `eventType`으로 이벤트를 발생시키면 트리거가 발동하여 연결된 Cloud Code 스크립트 또는 모듈이 실행됩니다.

### 트리거 검색##retrieve-triggers

`Fetch` 커맨드를 사용하면 원격 환경에서 여러 트리거를 한 번에 가져올 수 있습니다.

제공되는 경로는 트리거가 저장되는 디렉토리입니다.

```bash
ugs fetch <path>
```

### 트리거 삭제##delete-triggers

트리거를 삭제하려면 `deploy` 플래그를 포함해 `--reconcile` 커맨드를 실행합니다.

> **Warning:**
>
> **경고:** reconcile은 파괴적 작업입니다. 이 작업은 제공된 경로에 표시되지 않는 모든 트리거를 삭제합니다. 해당 커맨드를 실행하기 전에 이를 제외하고 `--dry-run` 플래그로 커맨드의 출력을 확인할 수 있습니다.

```bash
ugs deploy --services triggers <path-to-triggers-file> --reconcile
```