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

# 프로젝트 환경: AI 환경 구성, 환경 검토, 게시

> AI가 클라우드 서버에서 클라우드 프로젝트의 설치 스크립트, 시작 명령, 시크릿, 환경 변수를 구성하는 방법입니다. 환경 구성 페이지 열기, 3단계 환경 검토, 결과, 게시, 각 환경 상태의 의미를 설명합니다.

**프로젝트 환경**은 클라우드 프로젝트가 클라우드 서버에서 실행되는 데 필요한 것으로, 설치 스크립트, 시작 명령, 프로젝트가 사용하는 시크릿과 환경 변수로 구성됩니다. AI가 저장소를 읽고 설치 스크립트와 시작 명령을 생성하며, 누락된 시크릿과 변수를 나열합니다. **환경 검토**에서 확인하고 입력하면 AI가 클라우드 서버에서 설치 스크립트를 실행하며, 통과하면 게시합니다.

환경 구성은 선택 사항입니다. 프로젝트를 만들면 바로 세션을 시작할 수 있으며, 구성 상태는 세션 시작에 영향을 주지 않습니다. 로컬 프로젝트는 컴퓨터 자체의 환경을 사용하므로 이 단계를 건너뜁니다.

## 적용 범위

| 형태 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | |
| 웹 앱 | 지원 | |
| 모바일 웹 | 지원 | |

## 진입 경로

* **Project settings › Environment** 오른쪽의 편집 버튼(**Edit environment**).
* 프로젝트의 환경 변수 누락에 관한 알림. 환경 구성 페이지가 바로 열립니다.

환경 구성 페이지는 프로젝트의 별도 페이지입니다. 세션에 속하지 않으며 사이드바의 세션 목록에도 나타나지 않습니다.

## 환경 상태

**Settings › Workspace › Projects** 에서 각 클라우드 프로젝트의 환경 상태가 표시됩니다.

| 상태 | 의미 |
| - | - |
| **Environment not set up** | 환경이 구성되지 않았습니다. 바로 세션을 시작할 수 있습니다 |
| **Setting up** | 클라우드 서버에서 설치 스크립트가 실행 중입니다. 그동안에도 프로젝트를 계속 사용할 수 있습니다 |
| **Unpublished** | 설치 스크립트가 통과했지만 게시되지 않았거나, 게시된 환경에 변경이 있습니다 |
| **Setup failed** | 설치 스크립트가 통과하지 못했습니다. 다시 시도할 수 있습니다. 세션 시작에는 영향이 없습니다 |
| 라벨 없음 | 환경이 클라우드 서버에 게시되었습니다 |

## 첫 구성

환경 구성 페이지를 처음 열면 AI가 저장소를 바탕으로 초안(설치 스크립트, 시작 명령, 필요한 시크릿과 변수)을 생성합니다. **설치 스크립트는 환경 검토를 마친 후에만 실행됩니다.**

* 시크릿 또는 환경 변수가 누락되면 입력창 바로 위에 **Review environment** 카드가 열립니다.
* 누락된 것이 없으면 입력창 위의 **Edit environment** 를 클릭해 같은 카드를 열고 확인합니다.

AI의 작업 단계는 **Worked for 12s** 아래에 접혀 있습니다. 펼치면 볼 수 있습니다.

## 3단계 환경 검토

**Review environment** 카드는 3단계로 구성됩니다. **Next** 와 **Skip** 으로 진행하고, 마지막 단계에서 **Finish review** 를 클릭합니다. 필수 항목이 누락되었으면 **Later** 를 클릭해 카드를 **Needs your input** 한 줄로 접을 수 있습니다. 클릭하면 다시 펼쳐지며, 입력한 값은 유지됩니다.

1. **Confirm setup and start**: AI가 생성한 **Setup script**(환경을 만들 때와 의존성이 바뀔 때 실행)와 **Start command**(매번 깨어난 후 실행)를 확인합니다. 편집 버튼을 클릭해 변경할 수 있습니다.
2. **Configure secrets**: 각 시크릿의 값을 입력합니다. 이미 저장된 시크릿은 비워 두면 그대로 유지됩니다. **Workspace** 로 표시된 행은 워크스페이스 수준으로 권장되며 워크스페이스의 프로젝트가 공유합니다. 그 밖의 행은 이 프로젝트의 시크릿으로 저장됩니다. 이름에는 영문자, 숫자, 밑줄만 사용할 수 있으며 숫자로 시작할 수 없습니다.
3. **Configure environment variables**: AI가 값을 제안한 변수는 미리 채워져 있습니다. 변경하거나 **Add variable** 을 클릭할 수 있습니다. 저장된 변수는 값이 표시되지 않으며, 비워 두면 유지됩니다.

시크릿과 환경 변수 단계에서는 필수 값을 모두 입력해야 **Next** 를 사용할 수 있습니다.

## 검토 후

**Finish review** 를 클릭하면 페이지에 요약 **You finished the environment review**(설치와 시작을 변경했는지, 어떤 시크릿을 저장했는지, 환경 변수 수)가 표시되고, 이후 AI가 확인된 스크립트로 클라우드 서버에서 설치 스크립트를 실행합니다. 시크릿 값은 페이지에 표시되지 않습니다.

## 구성 결과

### 환경 준비 완료

설치 스크립트가 통과하면 **my-app is ready** 가 있는 환경 카드가 나타나며, 저장소, 런타임, 설치 스크립트, 시작 명령, 시크릿(값이 없는 항목에는 **(missing)** 표시), 환경 변수 수가 나열됩니다.

* **Edit**: 검토 카드를 다시 열어 변경한 다음 다시 실행할 수 있습니다.
* **Publish to cloud server**: 게시하면 카드가 **my-app is published** 로 바뀝니다. **Start a task** 를 클릭하면 이 프로젝트가 선택된 새 세션 페이지가 열립니다.

### 구성 실패

설치 스크립트가 통과하지 못하면 오류 메시지가 표시됩니다. 세션 시작에는 영향이 없습니다.

* **Retry**: 최신 스크립트를 다시 실행합니다.
* **Edit environment**: 스크립트를 변경한 다음 **Finish review** 를 클릭해 다시 실행합니다.

## 요청 추가

구성이 실패했거나, 준비되었거나, 게시된 후에는 페이지 하단의 입력창(**Ask for follow-up changes**)에서 요청을 보낼 수 있으며, AI가 그에 따라 환경을 다시 구성합니다. 구성이 진행 중일 때는 보낼 수 없으며, 여기서는 모델을 변경할 수 없습니다.

## 게시된 환경 변경

**Project settings › Environment** 에서 환경 구성 페이지를 열고 **Edit environment** 를 클릭한 다음, 변경 후 **Finish review** 를 클릭해 설치 스크립트를 다시 실행합니다. 통과하면 프로젝트가 **Unpublished** 상태가 됩니다. 변경 사항을 적용하려면 **Publish to cloud server** 를 다시 클릭합니다.

**Settings › Workspace › Secrets & variables** 에서 프로젝트 수준의 시크릿과 변수를 직접 변경할 수도 있습니다. [워크스페이스 설정](https://docs.aihubmix.com/ko/cloud/settings/workspace.md)을 참고하세요. 변수를 삭제한 후 실행 중인 환경은 다시 시작하면 변경 사항을 반영합니다.

## 참고 사항 및 제한

* 세션이나 환경 구성 페이지의 입력창에 시크릿을 직접 보내지 마세요. 환경 검토 또는 **Settings › Workspace › Secrets & variables** 에서 입력하세요.
* 클라우드 환경은 공용 인터넷에만 접근할 수 있습니다.
* 환경 구성은 클라우드 서버의 클라우드 프로젝트에만 적용됩니다.

## 자주 묻는 질문

### 환경 검토를 건너뛰었습니다. 나중에 시크릿을 추가할 수 있나요?

네. **Settings › Workspace › Secrets & variables** 에서 추가하거나, 환경 구성 페이지로 돌아가 **Edit environment** 를 클릭하세요.

### 게시하기 전에 설치 스크립트를 변경할 수 있나요?

네. 환경 카드의 **Edit** 를 클릭하거나, 검토의 1단계에서 직접 편집하세요.

### 프로젝트를 만든 후 구성이 왜 자동으로 시작되지 않았나요?

환경 구성은 선택 사항입니다. 필요하면 **Project settings › Environment** 로 이동해 편집 버튼을 클릭하세요.

## 관련 문서

* [프로젝트](https://docs.aihubmix.com/ko/cloud/projects/projects.md)
* [워크스페이스 설정](https://docs.aihubmix.com/ko/cloud/settings/workspace.md)
* [실행 환경: 내 기기와 클라우드 서버](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)
* [클라우드 서버](https://docs.aihubmix.com/ko/cloud/cloud-host/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.