> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md).

# 앱 및 버전

Edgegap 애플리케이션과 버전이 작동하는 방식, 게임 서버 빌드의 버전 관리를 하고 환경을 분리하는 모범 사례를 설명합니다.

버전 관리와 애플리케이션에 대해 알아보세요 - 더 깊이 이해하기 위한 개념과 모범 사례.

## 📦 애플리케이션

애플리케이션은 서버 프로젝트를 캡슐화합니다. 이러한 문맥 분리는 다음과 같은 경우 특히 유용합니다:

* 여러 게임 또는 비게임 프로젝트를 작업하는 경우(통합 청구),
* 외부 프로젝트에 공동 개발자로 참여하는 경우(나중에 소유권 이전),
* 서로 다른 확장 패턴이나 요구 사항을 가진 여러 개의 느슨하게 결합된 서버 유형에 의존하는 경우.

Edgegap에서 저희 플러그인을 사용해 애플리케이션을 관리할 수 있으며, [대시보드](https://app.edgegap.com/application-management/applications/list) 또는 저희 API를 사용할 수 있습니다.

{% hint style="success" %}
저희 [애플리케이션 API 참조](https://docs.edgegap.com/api/#tag/Applications)를 살펴보거나 저희 [관리 API](https://docs.edgegap.com/api/).
{% endhint %}

## 🏷️ 앱 버전

애플리케이션을 개발하고 새로운 빌드를 계속 생성함에 따라, 각 빌드를 별도의 버전으로 저장해야 합니다. 이는 다음을 위해서입니다:

* **호환성 유지** 클라이언트와 서버 간의
* 귀하의 다양한 측면을 비교하고 **점진적 릴리스** (성능, 사용자 반응),
* 테스트하고 **여러 앱 버전을 동시에** (개발, 품질 보증, 스테이징, 베타).

{% hint style="info" %}
각 앱 버전은 원하는 하나의 빌드 아티팩트를 가리킵니다. 여러 버전이 같은 빌드를 가리킬 수 있습니다.
{% endhint %}

Edgegap에서 저희 [대시보드](https://app.edgegap.com/application-management/applications/list) 또는 저희 API를 사용할 수 있습니다.

{% hint style="success" %}
저희 [앱 버전 API 참조](https://docs.edgegap.com/api/#tag/Applications/operation/app-version-post)를 사용해 앱 버전을 관리할 수 있으며, 또는 [API](https://docs.edgegap.com/api/).
{% endhint %}

각 버전은 상위 애플리케이션 내에서 고유하게 다음으로 식별됩니다: **앱 버전 이름**. 원하는 네이밍 규칙을 자유롭게 정할 수 있습니다. 선택에 영감을 줄 수 있는 몇 가지 인기 있는 예시는 다음과 같습니다:

* `2024.01.30-16.23.00-UTC` - 타임스탬프는 많은 과거 버전을 보관하는 데 직관적이며,
* `1.1.0` - [시맨틱 버전 관리](https://semver.org/) 는 변경 범위를 전달하기에 좋은 선택입니다,
* `개발` , `스테이징`, `QA`, `프로덕션` - 환경별로 최신 버전만 유지하는 것이 매우 쉽습니다,
* `블루`, `그린` - 버전은 롤링 업데이트 배포 전략의 별칭으로 사용할 수 있습니다.

{% hint style="success" %}
클라이언트/서버 호환성을 유지하는 한 언제든지 접근 방식을 바꿀 수 있습니다.
{% endhint %}

{% hint style="info" %}
저희 [대시보드](https://app.edgegap.com/application-management/applications/list) 를 **사람(개발) 오류를 방지하고**.
{% endhint %}

{% hint style="info" %}
무료 티어는 애플리케이션 2개, 버전 2개, 그리고 컨테이너 레지스트리 저장소 10GB로 제한됩니다.
{% endhint %}

### 버전 관리 전략 결합하기

종종 가장 좋은 해결책은 다음과 같은 버전 관리 전략의 조합입니다:

* 개발 빌드에 타임스탬프나 시맨틱 버전 관리를 사용하여 더 세밀하게 추적하고;
* 유지하고 `스테이징`, `QA` 및 `프로덕션` 환경별 매개변수를 가진 버전들을;
* 번갈아 사용하는 `블루` 및 `그린` 버전을 별칭으로 [매치메이킹 다운타임이 없는 업데이트](https://docs.edgegap.com/docs/gen2-matchmaker#rolling-updates-ab-tests).

## 🧱 필수 매개변수

이러한 기본 매개변수는 항상 정의되어 있어야 합니다.

### 리소스 요구 사항

에 더해 **버전 이름**새 버전을 생성하려면 몇 가지 매개변수가 필요합니다:

* **vCPU** - 앱을 실행하는 데 필요한 가상 CPU 단위 수 (1024단위 = 1 vCPU),
  * **허용되는 최소 vCPU는 0.25 vCPU(256단위)입니다,**

{% hint style="info" %}
배포당 0.25 vCPU보다 적게 필요하신가요? [최적화 옵션을 알아보려면 문의하세요.](mailto:info@edgegap.com)
{% endhint %}

* **메모리** - 앱을 실행하는 데 필요한 RAM 용량(MB) (1024MB = 1GB),
* **GPU** - 앱을 실행하는 데 필요한 그래픽 처리 장치 수,
  * 이 기능은 아직 제공되지 않습니다. 관심 있으시면 문의해 주세요.

{% hint style="success" %}
버전에는 RAM:vCPU 비율 2:1로 RAM이 자동 포함되며, **0.25 vCPU에 512MB RAM이 제공됩니다**.
{% endhint %}

{% hint style="info" %}
저희 서버 머신은 위치에 따라 최대 3.7GHz의 클록 속도를 가진 AMD/Intel CPU를 사용합니다. 서버에 충분한 리소스가 있는지 확인하려면 [커뮤니티 디스코드](https://discord.gg/MmJf8fWjnt).
{% endhint %}

### 이미지 세부 정보

이러한 매개변수는 시스템이 나중에 서버의 어떤 빌드를 시작해야 할지 결정하는 데 도움이 됩니다:

* **레지스트리** - `registry.edgegap.com` 저희 [컨테이너 레지스트리](https://docs.edgegap.com/docs/container/edgegap-container-registry),
  * 타사 레지스트리를 사용하려면 타사 레지스트리의 Docker 자격 증명을 입력하세요,
  * 레지스트리는 귀하와 다른 사용자의 저장소를 위한 공유 저장소 서비스 역할을 합니다.
* **이미지 저장소** - 귀하의 애플리케이션 전용 저장소를 의미합니다,
  * 모든 저장소는 저희 [대시보드의 컨테이너 레지스트리 페이지에서 찾을 수 있습니다](https://app.edgegap.com/registry-management/repositories/list),
  * 각 저장소에는 서버 이미지의 여러 태그가 포함될 수 있습니다.
* **태그** - 서버 이미지의 특정 빌드 아티팩트(버전)를 의미합니다,
  * 저희 플러그인은 기본적으로 앱 버전 이름에서 태그 값을 복사합니다,
  * Docker Desktop Images 또는 docker CLI에서 로컬에 저장된 태그를 볼 수 있습니다.

{% hint style="danger" %}
:x: **하지 마세요 - 기존 태그를 덮어쓰거나 사용 `최신` 태그** - 이렇게 하면 오래된 캐시가 배포됩니다.\
:white\_check\_mark: **하세요 - 버전 태그를 항상 증가시키세요** 그리고 새 빌드를 배포하세요.
{% endhint %}

* **비공개 레지스트리** - 저장소 접근이 보호되는 경우(비공개 저장소), 다음도 필요합니다:
  * **사용자명 토큰** - 레지스트리의 프로그래매틱 접근 사용자명,
  * **비밀번호 토큰** - 레지스트리의 프로그래매틱 접근 비밀번호,
  * Edgegap의 경우 [컨테이너 레지스트리](https://docs.edgegap.com/docs/container/edgegap-container-registry)다음 [값들을 대시보드에서 복사](https://app.edgegap.com/registry-management/repositories/list),
  * 이는 공개 저장소에는 필요하지 않습니다.

<details>

<summary>문제 해결 및 FAQ</summary>

오류가 발생했습니다 `401 인증되지 않음` 서버 이미지를 푸시할 때.

* 이는 컨테이너 레지스트리에 로그인하지 않았음을 의미합니다. 다음을 참조하여 컨테이너 레지스트리에서 [Edgegap 컨테이너 레지스트리 안내](https://docs.edgegap.com/docs/container/edgegap-container-registry#getting-your-credentials)또는 사용 중인 레지스트리 제공업체에 해당하는 안내를 참고하세요. 마지막 작업을 반복해도 오류는 해결되지 않습니다.

***

오류가 발생했습니다 `403 금지됨` 서버 이미지를 푸시할 때.

* 이는 현재 로그인한 레지스트리 사용자의 권한이 충분하지 않거나(보통 새 이미지를 푸시하는 권한), 잘못된 레지스트리 제공업체에 로그인했음을 의미합니다. 로그아웃한 뒤 올바른 제공업체와 충분한 권한이 있는 사용자로 다시 로그인해 보세요. 마지막 작업을 반복해도 오류는 해결되지 않습니다.

***

레지스트리, 저장소, 프로젝트의 차이점은 무엇인가요?

* 레지스트리를 창고, 저장소를 보관함, 프로젝트를 보관함 번호라고 생각하면 됩니다. 각 레지스트리에는 일반적으로 여러 저장소가 포함되며, 일부는 공개이고 일부는 조직 및 사용자 전용 비공개입니다.
* 예시 레지스트리: `registry.edgegap.com` .
* 예시 저장소: `registry.edgegap.com/my-edgegap-org/my-game-server`.
* 예시 프로젝트 이름: `my-game-server` .

***

새 이미지 태그 / 빌드를 푸시할 때 변경 사항이 제대로 다시 로드되지 않습니다.

* 매번 다시 빌드할 때 새로운 이미지 태그로 푸시하세요. Edgegap의 내부 캐싱 시스템은 태그 이름을 사용하며, 태그 값을 덮어쓰는 경우(예: `latest`) 새 빌드를 인식하지 못합니다.

***

같은 빌드 아티팩트에 여러 번 태그를 붙일 수 있나요?

* 네, 동일한 아티팩트에 여러 번 태그를 붙여도 문제없으며, 같은 빌드에 대한 여러 별칭 역할을 합니다. 나중에 태그를 제거하는 방법을 계속 읽어보세요.

***

태그를 삭제하면 어떻게 되나요? 해시를 사용해 특정 아티팩트를 삭제할 수 없는 이유는 무엇인가요?

* 레지스트리의 공간을 확보하려면 특정 아티팩트와 연결된 모든 태그를 삭제해야 합니다.
* Docker API 표준과 최상의 사용자 경험을 보장하기 위해, 저희는 태그를 삭제하는 인터페이스만 제공합니다. 빌드 아티팩트 삭제에 관한 위의 항목을 참조하세요.

</details>

## ⚙️ 선택적 매개변수

이러한 매개변수는 배포를 추가로 사용자 지정하도록 설정할 수 있습니다.

### 주입된 변수

이 버전의 모든 배포에 사용자 지정 환경 변수가 주입됩니다:

* 일반적인 예로는 엔진 인수, 타사 시크릿, 엔드포인트 등이 있습니다,
* 참조하세요 [배포](/ko/learn/orchestration/deployments.md#injected-environment-variables) 앱 버전 변수 외에도 배포의 문맥에 따라 환경 변수가 주입될 수 있는 다양한 방식을 이해하려면
* 각 환경 변수에는 최대 4KB(킬로바이트)의 문자열 데이터를 포함할 수 있습니다.

{% hint style="warning" %}
반드시 **민감한 변수(시크릿, 토큰)는 숨김** 으로 설정하세요
{% endhint %}

### 활성 캐싱

:star2: [**종량제 요금제로 업그레이드하세요**](https://app.edgegap.com/user-settings?tab=memberships) **전 세계 어디서나 0.5초 배포 시간을 이용할 수 있습니다!**

**배포를 더 빠르게 하고 대기 서버 없이 몇 초 만에 서버를 시작하세요.** 이 앱 버전에 연결된 서버 이미지는 전 세계 모든 위치에 자동으로 미리 로드됩니다.

앱 버전의 캐싱 수준이 🟢 Good에 도달하면 캐싱이 완전히 적용됩니다.

{% hint style="success" %}
여러 앱 버전이 동일한 이미지 태그를 재사용할 수 있습니다. **한 버전에 캐시를 활성화하면 동일한 이미지 태그에 연결된 모든 버전에 자동으로 활성화됩니다**매개변수화된 배포가 쉬워집니다.
{% endhint %}

{% hint style="info" %}
이미지는 배포 시에도 수동적으로 캐시되며, 배포된 호스트 머신에서만 적용됩니다.
{% endhint %}

{% hint style="warning" %}
**이미지는 72시간 연속으로 배포되지 않으면 캐시에서 제거됩니다.**
{% endhint %}

### 포트 매핑

각 서버는 들어오는 클라이언트 연결을 수락하기 위해 최소 하나의 포트가 필요합니다:

* **포트** 값은 **내부 포트** 값을 의미하며, 일반적으로 netcode 통합에서 가져옵니다,
* **프로토콜** 는 netcode 통합의 전송 방식에 따라 달라집니다,
* **이름** 는 사용자를 위한 사람이 읽을 수 있는 식별자이며, 포트와 같을 수도 있습니다,
* **검증** 를 활성화하여 컨테이너가 READY로 표시되기 전에 초기화되었는지 확인할 수 있습니다.

{% hint style="success" %}
대부분의 게임은 포트에 대해 단일 UDP 포트 매핑만 추가하면 됩니다 `7777`.
{% endhint %}

서버 프로세스의 내부 포트는 앱 버전의 일부로 정의되지만, **외부 포트는 배포가 생성되면 무작위로 할당됩니다**잠재적인 악의적 행위자(해커)가 피해를 입히기 전에 속도가 늦춰지고 탐지되도록 하기 위함입니다.

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FXfDDoCk7J4O9qtkkjurh%2Fimage.png?alt=media&amp;token=a509cc92-a410-4658-9dcd-b032497debb5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
서버가 여러 프로토콜로 통신한다면 포트 매핑에 더 많은 포트를 추가하세요.
{% endhint %}

### 안전 가드레일

이러한 매개변수는 다양한 예외 상황과 일반적인 서버 문제 해결에 도움이 됩니다:

* **시간 제한** - 이러한 기능은 배포의 리소스 수명 주기를 관리하는 데 도움이 됩니다:
  * **게임 최대 지속 시간** 를 설정하여 일정 기간 후 서버를 우아하게 종료하도록 하거나, 다음으로 설정할 수 있습니다 `-1`  와 함께 [앱 버전 API 생성/편집](/ko/docs/api/versioning.md#post-v1-app-app_name-version) 에 대한 [지속성](/ko/learn/orchestration/persistence.md) 와 함께 [프라이빗 플릿](/ko/learn/orchestration/private-fleets.md).
  * **최대 배포 시간** 시작하는 데 너무 오래 걸리는 배포를 정리하는 데 도움이 됩니다.
* **프로세스 재시작 정책** - 서버 프로세스가 중지될 때의 배포 동작을 제어합니다.
  * 항상 재시작(기본값) - 정상 종료 코드(0) 및 모든 오류 종료 시 재시작합니다.
  * 절대 재시작(권장) - 성공 및 오류 종료 코드에서 배포가 중지됩니다.
  * 충돌 시 재시작 - 오류 종료 코드에서만 재시작하며, 지속형 서버에 유용합니다.

{% hint style="info" %}
무료 티어는 애플리케이션 2개, 버전 2개, 그리고 컨테이너 레지스트리 저장소 10GB로 제한됩니다.
{% endhint %}

### 로그 저장소

배포가 중지된 후 서버 로그를 내보내려면 다음을 구성하세요 [엔드포인트 스토리지](/ko/docs/endpoint-storage.md) S3 버킷을 사용하여.

{% hint style="warning" %}
외부 저장소가 없는 버전의 로그는 배포 종료 시 삭제됩니다.
{% endhint %}

## ⏩ 업데이트 일관성

저희 [대시보드](https://app.edgegap.com/application-management/applications/list)를 통해 새 앱 버전을 생성할 때 매개변수가 변경되지 않도록 하려면, 다음 사용을 권장합니다 **복제** 이전 앱 버전 대시보드 페이지 오른쪽 상단의 기능을 사용하세요. 복제할 때 저장 전에 어떤 매개변수든 편집할 수 있습니다.

{% hint style="success" %}
**앱 버전을 복제하거나 편집해도 서버 이미지를 다시 빌드할 필요는 없습니다.**
{% endhint %}

{% hint style="info" %}
다음을 참조하세요 [매치메이커 롤링 업데이트](https://docs.edgegap.com/docs/gen2-matchmaker#rolling-updates-ab-tests) 추가 **릴리스 자동화**.
{% endhint %}