> ## Documentation Index
> Fetch the complete documentation index at: https://aircloud.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Air Container

> AI 컨테이너를 Air Cloud에 배포하세요

Air Container는 컨테이너 기반의 AI 서비스를 빠르고 효율적으로 배포할 수 있도록 지원합니다. 이용 방법은 다음과 같습니다:

## 배포 흐름

### 1단계. 프로젝트 선택

<Frame caption="프로젝트 선택">
  <img src="https://mintcdn.com/aircloud/6Ic5gbgYkO3hL9Pq/docs/images/air-container/select-a-project.png?fit=max&auto=format&n=6Ic5gbgYkO3hL9Pq&q=85&s=1709e826ee95e9a709237f9423215793" style={{ borderRadius: "0.5rem" }} width="1920" height="480" data-path="docs/images/air-container/select-a-project.png" />
</Frame>

프로젝트 대시보드(Project Dashboard)로 이동한 뒤, 초기설정 과정 중에 생성한 조직과 프로젝트를 선택합니다.

<Frame caption="컨테이너 페이지">
  <img src="https://mintcdn.com/aircloud/6Ic5gbgYkO3hL9Pq/docs/images/air-container/container-page.png?fit=max&auto=format&n=6Ic5gbgYkO3hL9Pq&q=85&s=38ba784695c4c9e20cc0dd1559210bad" style={{ borderRadius: "0.5rem" }} width="1920" height="1038" data-path="docs/images/air-container/container-page.png" />
</Frame>

프로젝트 페이지의 서비스 탭에서 **"컨테이너(Container)"** 서비스를 선택하고 **\[+ Create]** 버튼을 클릭하여 새 컨테이너를 생성합니다.

### 2단계. 기본 설정

<Frame caption="General 정보 입력">
  <img src="https://mintcdn.com/aircloud/6Ic5gbgYkO3hL9Pq/docs/images/air-container/enter-general-information.png?fit=max&auto=format&n=6Ic5gbgYkO3hL9Pq&q=85&s=98e821dfdacd7a0166cad354a1688746" style={{ borderRadius: "0.5rem" }} width="1224" height="356" data-path="docs/images/air-container/enter-general-information.png" />
</Frame>

<br />

<Frame caption="Image 정보 입력">
  <img src="https://mintcdn.com/aircloud/6Ic5gbgYkO3hL9Pq/docs/images/air-container/enter-container-image-information.png?fit=max&auto=format&n=6Ic5gbgYkO3hL9Pq&q=85&s=92ec39de5aeac5ff9e822dea0a1eb67a" style={{ borderRadius: "0.5rem" }} width="1224" height="696" data-path="docs/images/air-container/enter-container-image-information.png" />
</Frame>

컨테이너 생성 시 다음 항목들을 입력해야 합니다:

<ResponseField name="이름(Name)" type="string" required>
  컨테이너를 식별하기 위한 사용자 정의 이름
</ResponseField>

<ResponseField name="카테고리(Category)" type="string">
  컨테이너가 제공하는 서비스 유형 (향후 Playground 연동에 사용됩니다)
</ResponseField>

<ResponseField name="컨테이너 이미지(Container Image)" type="url" required>
  컨테이너의 Docker 이미지 URL
</ResponseField>

<ResponseField name="레지스트리 제공자(Registry Provider)" type="string" required>
  이미지가 호스팅된 레지스트리 (예: GitHub Container Registry, Docker Hub 등)
</ResponseField>

<ResponseField name="레지스트리 사용자 이름 및 비밀번호" type="string">
  프라이빗 레지스트리에서 이미지를 불러올 경우 입력 필요
</ResponseField>

### 3단계. 리소스 구성

<Frame caption="리소스 설정">
  <img src="https://mintcdn.com/aircloud/6Ic5gbgYkO3hL9Pq/docs/images/air-container/resource-settings.png?fit=max&auto=format&n=6Ic5gbgYkO3hL9Pq&q=85&s=f347678f536165a8df45ff478392a615" style={{ borderRadius: "0.5rem" }} width="1920" height="1590" data-path="docs/images/air-container/resource-settings.png" />
</Frame>

* **일반 모드(General Mode)**: 인스턴스 유형을 선택합니다 (예: RTX 4070, 4090).
* **오토스케일 모드(Autoscaling Mode)**: 최소 및 최대 복제 수를 설정합니다 (1\~30개). 그 이상의 높은 수치를 설정할 경우 관리자 승인이 추가적으로 필요합니다.

### 4단계. 고급 설정

<Frame caption="고급 설정">
  <img src="https://mintcdn.com/aircloud/6Ic5gbgYkO3hL9Pq/docs/images/air-container/advanced-settings.png?fit=max&auto=format&n=6Ic5gbgYkO3hL9Pq&q=85&s=cdb7425b3abac389ddb370e3d0b13e38" style={{ borderRadius: "0.5rem" }} width="1030" height="670" data-path="docs/images/air-container/advanced-settings.png" />
</Frame>

Advanced 섹션에서는 다음과 같은 추가 옵션을 설정할 수 있습니다:

<ResponseField name="시작 명령어(Start Command)" type="string">
  컨테이너 이미지의 기본 시작 명령어를 재정의
</ResponseField>

<ResponseField name="포트(Port)" type="number">
  컨테이너에서 기본 노출할 포트 재정의
</ResponseField>

<ResponseField name="헬스 체크 URL(Health Check URL)" type="url">
  컨테이너의 상태를 확인할 헬스 체크 URL 지정. (예: /api/health).
</ResponseField>

<ResponseField name="환경 변수(Environment Variables)" type="object">
  애플리케이션 실행에 필요한 key-value 형태 설정 (예: DB 인증 정보, API 키 등)
</ResponseField>

### 5단계. 검토 및 배포

<Frame caption="검토 페이지">
  <img src="https://mintcdn.com/aircloud/6Ic5gbgYkO3hL9Pq/docs/images/air-container/review-page.png?fit=max&auto=format&n=6Ic5gbgYkO3hL9Pq&q=85&s=4b561b81c1452a086ccdc720977e25c6" style={{ borderRadius: "0.5rem" }} width="1920" height="1642" data-path="docs/images/air-container/review-page.png" />
</Frame>

### 6단계. 배포 완료

<Frame caption="배포된 Container 정보">
  <img src="https://mintcdn.com/aircloud/6Ic5gbgYkO3hL9Pq/docs/images/air-container/deployment-completion.png?fit=max&auto=format&n=6Ic5gbgYkO3hL9Pq&q=85&s=bccf1ad96c5d9eab2075ab3bc2e97980" style={{ borderRadius: "0.5rem" }} width="1996" height="726" data-path="docs/images/air-container/deployment-completion.png" />
</Frame>

컨테이너가 배포 즉시 실행되며, API 엔드포인트 또는 서비스 URL이 자동으로 제공됩니다.

* 생성된 컨테이너는 좌측 목록에 표시됩니다.
* 목록에서 항목을 선택하면 우측 패널에 상세 정보가 표시됩니다.
* 우측 패널에서 컨테이너 설정을 수정할 수 있습니다.
* "대시보드(Dashboard)" 버튼을 클릭하면, 컨테이너 상태 및 활동 로그를 확인할 수 있는 상세 관리 페이지로 이동합니다.

## API 요청

컨테이너 상태가 실행 중(RUNNING)일 때, 노출된 엔드포인트를 통해 AI 추론 API에 접근할 수 있습니다. 요청 시 호스트 주소 부분을 해당 컨테이너의 엔드포인트 URL로 교체해야 합니다.

```bash cURL theme={null}
curl --request POST \
     --url ${ENDPOINT_URL}/api/v1/chat/completions \
     --header "Accept: application/json" \
     --header "Authorization: Bearer ${YOUR_API_KEY}" \
     --header "Content-Type: application/json" \
     --data '{
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Write a haiku about recursion in programming."
    }
  ]
}'
```