기본 패턴
text
클라우드 작업 순서
1. 컨테이너 생성 + 저장소 checkout
2. setup script 실행
3. 인터넷 접근 정책 적용
4. 에이전트가 명령 실행, 수정, 검증
5. 결과 diff와 답변 표시설명
- Cloud Environment는 Codex가 원격 작업을 할 때 어떤 런타임과 도구, 환경 변수를 갖고 시작할지를 정하는 설정입니다.
- 공식 문서 기준으로 작업을 제출하면 먼저 컨테이너가 만들어지고 저장소가 체크아웃되며, 그다음 준비 스크립트인
setup script가 실행됩니다. - 에이전트 단계의 인터넷 접근은 기본적으로 꺼져 있지만, setup 단계는 의존성 설치를 위해 네트워크를 사용할 수 있습니다.
- 일반 환경 변수는 setup과 agent 전체에서 유지되지만,
secrets는 보안상 setup 단계에서만 풀리고 agent 단계 전에 제거됩니다. - 환경 캐시는 최대 12시간 유지될 수 있어 후속 작업이 빨라집니다. 대신
setup script,maintenance script, 환경 변수,secrets가 바뀌면 캐시가 무효화될 수 있습니다.
짧은 예제
bash
# 예시 setup script 아이디어
pip install pyright
poetry install --with test
pnpm install빠른 정리
| 요소 | 역할 |
|---|---|
| setup script | 컨테이너 초기 준비 |
| maintenance script | 캐시 재사용 시 후속 보정 |
| environment variables | 작업 전체에서 유지되는 값 |
| secrets | setup 단계에서만 쓰는 민감 정보 |
| container cache | 후속 작업 속도 향상 |
주의할 점
setup script에서 export한 값은 agent 단계로 자동 유지되지 않습니다. 지속돼야 하는 값은
환경 설정에 넣거나 문서가 안내하는 방식으로 별도 구성해야 합니다. 또 secret은 agent
단계에서 사라지므로, 에이전트가 직접 읽어야 하는 값으로 설계하면 안 됩니다.
참고 링크
3 sources