메인 콘텐츠로 건너뛰기
프로젝트 환경은 클라우드 프로젝트가 클라우드 서버에서 실행되는 데 필요한 것으로, 설치 스크립트, 시작 명령, 프로젝트가 사용하는 시크릿과 환경 변수로 구성됩니다. AI가 저장소를 읽고 설치 스크립트와 시작 명령을 생성하며, 누락된 시크릿과 변수를 나열합니다. 환경 검토에서 확인하고 입력하면 AI가 클라우드 서버에서 설치 스크립트를 실행하며, 통과하면 게시합니다. 환경 구성은 선택 사항입니다. 프로젝트를 만들면 바로 세션을 시작할 수 있으며, 구성 상태는 세션 시작에 영향을 주지 않습니다. 로컬 프로젝트는 컴퓨터 자체의 환경을 사용하므로 이 단계를 건너뜁니다.

적용 범위

진입 경로

  • Project settings › Environment 오른쪽의 편집 버튼(Edit environment).
  • 프로젝트의 환경 변수 누락에 관한 알림. 환경 구성 페이지가 바로 열립니다.
환경 구성 페이지는 프로젝트의 별도 페이지입니다. 세션에 속하지 않으며 사이드바의 세션 목록에도 나타나지 않습니다.

환경 상태

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

첫 구성

환경 구성 페이지를 처음 열면 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 에서 프로젝트 수준의 시크릿과 변수를 직접 변경할 수도 있습니다. 워크스페이스 설정을 참고하세요. 변수를 삭제한 후 실행 중인 환경은 다시 시작하면 변경 사항을 반영합니다.

참고 사항 및 제한

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

자주 묻는 질문

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

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

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

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

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

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

관련 문서