# 기업용 라이브 마이그레이션 CLI 참고 문서

CLI 도구 ELM에 대한 자세한 사용 정보입니다.

>[!NOTE] 
Enterprise Live Migrations 가 있으며 공개 미리 보기 변경될 수 있습니다.

## `elm migration` 명령어

| 명령 | Description |
|---|---|
| `elm migration create` | 단일 원본 리포지토리에 대한 새 마이그레이션을 만듭니다. |
| `elm migration start --migration-id MIGRATION-ID` | 마이그레이션 시작 |
| `elm migration status --migration-id MIGRATION-ID` | 마이그레이션의 상태, 진행률, 중단 준비 상태 및 타이밍 표시 |
| `elm migration list` | 모든 마이그레이션 및 해당 상태를 나열합니다. |
| `elm migration cancel --migration-id MIGRATION-ID` | 진행 중인 마이그레이션을 취소합니다. |
| `elm migration cutover-to-destination --migration-id MIGRATION-ID` | 최종 중단을 시작하고 원본 리포지토리를 보관하고 마이그레이션을 완료합니다. |

이러한 명령 중 일부는 추가 옵션을 사용할 수 있습니다. 이 문서의 이후 섹션을 참조하세요.

## `elm migration create` 옵션

리포지토리 내보내기 및 가져오기를 준비하는 새 마이그레이션을 만듭니다.

| Flag | 필수 | Default | Description |
|---|---|---|---|
| `--source-org` | Yes | N/A | 원본 조직의 슬러그 GitHub Enterprise Server |
| `--source-repo` | Yes | N/A | 원본 리포지토리의 이름 |
| `--target-org` | Yes | N/A | 대상 조직의 슬러그가 GHE.com에 있음 |
| `--target-repo` | Yes | N/A | 대상 리포지토리의 이름 |
| `--target-api` | Yes | N/A | 대상 엔터프라이즈의 API URL입니다(예: `https://api.octocorp.ghe.com`). URL의 끝에 후행 슬래시를 포함하지 **마세요** . |
| `--pat-name` | Yes | N/A | 정적 문자열로 설정해야 합니다. `system-pat` |
| `--target-visibility` | 아니오 | `internal` | 대상 리포지토리의 표시 여부입니다. 
`private` 또는 `internal`이어야 합니다. 공용 리포지토리는 지원되지 않습니다. |
| `--start` | 아니오 | `false` | 마이그레이션을 만든 후 자동으로 시작 |

## `elm migration list` 옵션

| Flag | 필수 | Default | Description |
|---|---|---|---|
| `--status` | 아니오 | N/A | 마이그레이션 상태를 사용하여 결과를 필터링합니다. 유효한 값: `created`,`queued`, `in_progress`, `paused``completed`, `failed``terminated`. |
| `--page-size` | 아니오 | N/A | 페이지당 결과 수 |
| `--after` | 아니오 | N/A | 이전 응답의 페이지네이션 커서 |

## `elm migration cutover-to-destination` 옵션

| Flag | 필수 | Default | Description |
|---|---|---|---|
| `--migration-id` | Yes | N/A | 중단할 준비가 된 마이그레이션의 ID입니다. |
| `--force` | 아니오 | `false` | 기본적으로 이 명령은 계속하기 전에 마이그레이션 대상이 준비 상태를 보고하는지 여부를 확인합니다. 마이그레이션 상태가 올바르다고 확신하는 경우 이 검사를 바이패스하는 데 사용합니다 `--force` . |

## 전역 플래그 및 변수

다음 속성은 환경 변수로 또는 명령의 플래그로 제공될 수 있으며, 플래그의 경우 우선 순위가 더 높습니다. 구성을 적용한 __`ghe-config` 이러한 값을 설정해야 합니다.

| 변수 | Flag | 필수 | Description |
|----------|------|----------|-------------|
| API_URL | `--api-url` | Yes | 
`http://localhost:1738`로 설정해야 합니다. |
| MIGRATION_MANAGER_HMAC_KEY | `--migration-manager-hmac-key` | Yes | 
`$(ghe-config secrets.elm-exporter.elm-exporter-hmac-keys)`로 설정해야 합니다. |
| MIGRATION_TARGET_URL | `--migration-target-url` | Yes | 대상 엔터프라이즈의 API URL입니다(예: `https://api.octocorp.ghe.com`). URL의 끝에 후행 슬래시를 포함하지 **마세요** . |
| MIGRATION_TARGET_TOKEN | `--migration-target-token` | Yes | personal access token (classic) 을 위한 GHE.com |
| DEBUG_HTTP | `--debug-http` | 아니오 | 디버깅을 위해 각 요청에 대한 HTTP 메서드, URL, 헤더 및 오류 응답 본문을 인쇄하도록 `true` 설정 |