> 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에서 우리의 플러그인을 사용해 애플리케이션을 관리할 수 있습니다, [대시보드](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/) 는 변경 범위를 전달하는 데 훌륭한 선택입니다,
* `dev` , `staging`, `qa`, `prod` - 각 환경별로 최신 버전만 유지하기가 매우 쉽습니다,
* `blue`, `green` - 버전은 롤링 업데이트 릴리스 전략의 별칭으로 사용할 수 있습니다.

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

{% hint style="info" %}
다음에서 앱 또는 버전을 비활성화할 수 있습니다 [대시보드](https://app.edgegap.com/application-management/applications/list) 하여 **사람(개발) 실수로부터 보호**.
{% endhint %}

{% hint style="info" %}
무료 등급은 애플리케이션 2개, 버전 2개, Container Registry 저장소 5GB로 제한됩니다.
{% endhint %}

### 버전 관리 전략 결합

종종 최선의 해결책은 버전 관리 전략을 혼합하는 것입니다. 예를 들면:

* 더 세분화된 추적을 위해 개발 빌드에는 타임스탬프나 의미 기반 버전 관리를 사용하는 것;
* 유지하면서 `staging`, `qa` 그리고 `prod` 환경별 매개변수가 있는 버전;
* 교대로 `blue` 그리고 `green` 다음의 별칭으로 버전 사용 [매치메이킹 다운타임이 없는 업데이트](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 메가바이트 수(1024MB = 1GB),
  * 이 설정은 기존 앱 버전에서는 수정할 수 없으며, 새 버전을 만들어야 합니다.
* **GPU** - 앱이 실행되는 데 필요한 그래픽 처리 장치 수,
  * 이 기능은 아직 사용할 수 없습니다. 관심이 있으시면 문의해 주세요.

{% hint style="success" %}
버전에는 RAM: vCPU가 2:1 비율로 자동 포함됩니다, **0.25 vCPU당 최대 512MB RAM까지 허용됩니다**.
{% endhint %}

{% hint style="info" %}
당사의 서버 머신은 지역에 따라 2.4 - 3.2 GHz 클록 속도의 AMD/Intel CPU를 사용합니다. 서버에 충분한 리소스가 있는지 확인하려면 다음에서 문의해 주세요 [커뮤니티 디스코드](https://discord.gg/MmJf8fWjnt).
{% endhint %}

### 이미지 세부 정보

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

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

{% hint style="danger" %}
:x: **하지 마세요 - 기존 태그를 덮어쓰거나 `latest` 태그** 를 사용하지 마세요. 오래된(캐시된) 빌드가 배포되는 것을 방지하기 위해서입니다.\
:white\_check\_mark: **하세요 - 버전 태그는 항상 증가시키세요** 의도한 빌드를 배포하고 릴리스 문제를 방지하기 위해.
{% endhint %}

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

<details>

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

다음 오류를 받았습니다 `401 Unauthorized` 서버 이미지를 푸시할 때.

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

***

다음 오류를 받았습니다 `403 Forbidden` 서버 이미지를 푸시할 때.

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

***

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

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

***

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

* 빌드를 다시 만들 때마다 새 이미지 태그로 푸시해야 합니다. Edgegap의 내부 캐싱 시스템은 태그 이름을 사용하며, 태그 값을 덮어쓰면(예: `latest`) 새 빌드를 인식하지 못합니다.

***

같은 빌드 산출물에 여러 번 태그를 붙일 수 있나요?

* 예, 같은 산출물에 여러 번 태그를 붙여도 문제없으며, 같은 빌드의 여러 별칭 역할을 합니다. 나중에 태그를 제거하는 방법은 계속 읽어보세요.

***

태그를 삭제하면 어떻게 되나요? 해시를 사용해 특정 산출물을 왜 삭제할 수 없나요?

* 태그를 삭제하면, 해당 산출물에 연결된 다른 태그가 삭제 시점에 없다면 관련 빌드 산출물도 함께 삭제됩니다 [API 요청](https://docs.edgegap.com/api/#tag/Container-Registry/operation/image-tag-delete).
* 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초 배포 시간을 해제하세요!**

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

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

{% hint style="success" %}
여러 앱 버전이 같은 이미지 태그를 재사용할 수 있습니다. **한 버전에 캐싱을 활성화하면 같은 이미지 태그에 연결된 모든 버전에 자동으로 적용됩니다**, 매개변수화된 배포를 쉽게 만듭니다.
{% endhint %}

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

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

### 포트 매핑

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

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

{% hint style="success" %}
대부분의 게임은 포트 `7777`.
{% endhint %}

에 대해 단일 UDP 포트 매핑만 추가하면 됩니다. 서버 프로세스의 내부 포트는 앱 버전의 일부로 정의되지만, **외부 포트는 배포가 생성되면 무작위로 할당됩니다**, 이를 통해 잠재적 악의자(해커)가 피해를 주기 전에 느려지고 탐지되도록 합니다.

<figure><img src="/files/4ba971ec5dc2edf09fe8eb3467658441fa65db04" 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개, Container Registry 저장소 5GB로 제한됩니다.
{% 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 %}