_deployment_guide
ChatGPT[ai-space 배포/관리 지침] 핵심 원칙 변경 도구 호출 전: 프로젝트명 명시→작업 요약→'진행할까요?' 확인 필수. 조회는 바로 호출. 배포 플로우 1. list_my_spaces→빈 공간(project_id=null) 확인. 없음→중단, 1개→자동선택, 2개+→사용자 선택 후 space_id 전달 2. external_repo(connect)로 GitHub 연동 확인 후 방식 선택: A.GitHub배포 | B.로컬파일 | C.자연어생성 3. 런타임: php(8.2)|nodejs(20)|python(3.11)|static (미지원: go/java/rust). DB: mysql|pgsql|sqlite|없음 4. 소스 확인 — A:경로+검증 B:list_repos→선택 C:자연어섹션 5. project_name=사이트성격만. user_id 포함 금지(서버가 자동 prefix). 409시: update/새이름/force force=true→전부 삭제. '되돌릴 수 없습니다' 재확인 필수 기본 도메인: {user_id}-{name}.mycafe24.ai 6. 설정 요약→확인→호출 파일 업로드 curl 우선. 실패 시 upload_json (한번 json 전환되면 curl 복귀 불가). 신규: create_session→응답 suggest_archive 확인→분기 - suggest_archive=true (파일>10 or 단일>3MB or 합계>5MB): create_archive→.tar.gz curl→finalize - suggest_archive=false: 개별 curl POST→finalize(deploy=true) 업데이트: create_session(update=true) 동일 플로우, finalize(deploy=false)→update_project upload_json 제한: ≤10개 / 개별 ≤3MB / 합계 ≤5MB. 바이너리는 base64 + encoding:'base64' 플래그 필수. 자연어 생성 배포 DB: 환경변수만(DB_HOST/DB_PORT/DB_NAME/DB_USER(NOT DB_USERNAME)/DB_PASSWORD). 하드코딩금지. 소스: aispace_files/{name}/ 하위. /tmp 금지. 영속: /app/user_data/만 보존. 최초: aispace_files생성→create_session→curl→finalize(deploy=true) 업데이트: aispace_files/{name}/ 수정→create_session(update=true)→curl→finalize(deploy=false)→update_project 프로젝트 관리 수정: list_my_projects→소스:upload+update_project | 환경변수:project_env | 런타임:'재빌드됩니다'확인후 update 삭제: '영구 삭제. 프로젝트명 재입력'→delete_project 롤백: '이전 버전. DB유지'→rollback_project 백업: backup_project→응답 backup_download_url을 사용자에게 그대로 안내(7일 유효). DB 있으면 자동 덤프 포함. 환경변수: plain text전달. DB변수는 서버 자동 주입→설정 불필요. GitHub 연동 connect:상태확인→미연동시 connect_url | list_repos→선택 | repo_update:'최신코드로 재배포?' | disconnect:'배포기능 사용불가' WordPress A. 파일업로드: PHP8.2+MySQL8.0 자동. wp-config위치 자동감지. DB자동주입. .sql포함시 자동임포트. B. deploy_wordpress: Pod자동생성+wp-cli설치+관리자계정. wp_manage로 테마/플러그인/포스트 관리. 기술 레퍼런스 DB환경변수: DB_HOST|DB_PORT|DB_NAME|DB_USER(NOT DB_USERNAME)|DB_PASSWORD 영속: /app/user_data/만. project_name: user_id포함금지. 옵션(redis/memcached): Pod모드만. power(start|stop): 상태변경만. 업데이트순서: create_session(update=true)→curl→finalize(deploy=false)→update_project(앱만 재생성, DB유지)
backup_project
ChatGPTCreate backup snapshot of project (app data + user_data + MySQL/PostgreSQL dumps auto-included if DB containers present). Returns download URL (7 days valid) directly in response as 'backup_download_url'. Present the URL to the user so they can download immediately. Project must be in 'success' state. Set wait=true to block until completion.
deploy_project
ChatGPTDeploy new project from PUBLIC Git URL (anonymous clone). For PRIVATE or user-owned GitHub repos, use external_repo (GitHub App auth). Auto-detects runtime (PHP/Node/Python/Static). Requires empty space — call list_my_spaces first. 1 empty→auto-selected; 2+→pass space_id. 409 PROJECT_EXISTS: offer update/rename/force. force=true: 같은 ID 강제 재배포 — 컨테이너만 새로 만들고 base_uid/group/env/acl/domain/user_data/DB 데이터 모두 보존. 완전 삭제 원하면 웹콘솔 사용. force 사용 전 사용자 확인 필수. For local files, use project_upload. No Dockerfiles.
external_repo
ChatGPTGitHub App repo management (PUBLIC + PRIVATE via user's App installation). All operations target the repository's default_branch only — non-default branches are not accessible. repo_connect: check status, get connect_url | repo_disconnect: remove DB token | repo_list: list repos | repo_files: browse repo (read-only) | repo_write_file: commit single file then auto-redeploy linked project | repo_deploy: deploy new project from repo (repo_name required; force=true: 같은 ID 강제 재배포 — 컨테이너만 새로, base_uid/env/acl/domain/user_data/DB 모두 보존. 완전 삭제 원하면 웹콘솔 사용. force 사용 전 사용자 확인 필수.) | repo_update: redeploy latest commit All action names are prefixed with repo_ to avoid collision with the top-level deploy_project tool. MANDATORY pre-flight (repo_update / repo_write_file 호출 전): get_project_status 응답의 source 가 "github" 인지 확인. "internal" 이면 호출 금지 — update_project 또는 project_upload(update=true) 사용. 잘못 호출 시 서버가 SOURCE_MISMATCH 응답 (repo_write_file 은 commit 만 수행하고 자동 재배포 skip). 프로젝트 매칭 규칙 (오탐 방지): repo_update/repo_write_file 의 자동 매칭은 system.projects.github_repo 컬럼 LIKE 매칭으로 동작. 리포명과 프로젝트명이 달라도 1:1 매핑이면 자동 OK. 단: • 한 리포가 여러 프로젝트에 deploy 된 경우 → AMBIGUOUS_PROJECT 응답. 반드시 project_name 명시. • 가장 안전한 호출 패턴: 먼저 list_my_projects 로 실제 project_id 확인 → project_name 으로 정확히 명시 호출. • repo_name 만 넘기면 자동 lookup 이지만 1:N 또는 0건 케이스에서 의도와 달라질 수 있음 (project_name 명시 권장). Always show the guide field from response to user.
finalize_db_import
ChatGPTFinalize DB import after dump file upload completes.
get_job_status
ChatGPTGet async job status by job ID for jobs started with wait=false.
get_project_logs
ChatGPTGet project build/deployment logs for diagnosing failures.
get_project_status
ChatGPTGet project status, runtime info, resource usage, deployment history, and DB credentials. 응답 필드 source 로 프로젝트 유형 식별: - source="internal" → project_upload / deploy_project (PUBLIC URL) 로 deploy 됨. update 시 update_project 또는 project_upload(update=true) 사용. - source="github" → external_repo (GitHub App) 로 deploy 됨. update 시 external_repo 의 repo_update 또는 repo_write_file 사용. 모든 update/redeploy 호출 전 반드시 이 도구로 source 확인 후 적합한 update 도구 선택. 잘못 호출 시 SOURCE_MISMATCH 응답.
import_database
ChatGPTCreate an upload session for a user-provided SQL dump into a Pod-mode project (MySQL/PostgreSQL). Prepare only — this call does not write to the DB and does not inspect file contents. Returns upload_url; upload .sql/.sql.gz then call finalize_db_import (which overwrites existing data).
list_my_projects
ChatGPTList all projects owned by authenticated user. Call first when target project is unclear.
list_my_spaces
ChatGPTList all spaces: id, label, spec, memory/quota/conn_limit, project_id. Use to find empty spaces (project_id=null) before deploying.
project_acl
ChatGPTManage project access control. set_ip: mode=deny→block IP, mode=allow→whitelist (blocks all others) | clear_ip | set_geo: block country by ISO code | clear_geo | get_acl
project_env
ChatGPTManage project env vars (get|set|delete). DB/Redis vars are server-auto-injected — do not set manually.
project_option
ChatGPTAdd/remove Pod-mode add-ons (redis|memcached). Remove deletes all data for that service.
project_upload
ChatGPTSession-based file upload. Step 0 — capability self-check (MANDATORY before create_session): • If you have a Bash/shell tool available → mode='curl' (preferred: faster, no per-request size limits). • If you are sandboxed (browser/Canvas, no shell) → mode='json' (use upload_json after create_session). • Do NOT probe with which curl or any shell command. A sandboxed runtime cannot execute shell at all — the probe itself is the symptom. Decide from your own tool inventory. Mode lock policy: mode is locked at create_session time (NOT at first file upload). Once locked, the other path returns 409. To switch modes you MUST create a new session. Retry policy (json mode): 4xx → fail immediately (no retry). 5xx → retry 1–2 times. timeout → retry 1 time. Every retry MUST start from a NEW create_session (new batch_id) — never reuse a batch_id whose first attempt failed. Final-failure fallback: if json upload fails after retries, the response includes fallback_options listing alternatives (external_repo for GitHub App connect+deploy, deploy_project for public Git URL). Surface those options to the user instead of looping. 중요: 모든 시도 (신규 deploy / update / force / rebuild) 시 항상 새 create_session 부터 시작. 같은 batch_id 재사용 금지 — finalize 후 session+파일이 cleanup 되어 재사용 시 repo 유실 위험. update=true 호출 전 MANDATORY: get_project_status 응답의 source 가 "internal" 인지 확인. "github" 이면 호출 금지 — external_repo 의 repo_write_file 사용. 잘못 호출 시 서버가 SOURCE_MISMATCH 응답. create_session: files+repo required, mode recommended → batch_id+upload_url (mode locked at this point) create_archive: for 10+ files, compressed (curl only) finalize: batch_id required; deploy=true→push+deploy, false→push only status: check progress Create files under aispace_files/{name}/ — never /tmp.
site_verify
ChatGPTVerify deployed site HTTP accessibility. Optionally checks content/title. retry_on_fail=true for auto-rebuild.
update_project
ChatGPTUpdate existing project with latest code. App container recreated; DB data/options preserved. Set rebuild=true to force full image rebuild. MANDATORY pre-flight (둘 다 필수): 1) get_project_status 응답의 source 가 "internal" 인지 확인. "github" 이면 호출 금지 — external_repo 의 repo_update / repo_write_file 사용. 2) 기존 runtime 과 새 코드 runtime 일치 확인. 불일치 시 호출 금지 — 웹콘솔 삭제 후 재배포 안내. source 가드: 잘못 호출 시 서버가 SOURCE_MISMATCH 응답.
upload_json
ChatGPTJSON upload path. Required when create_session was called with mode='json' (sandboxed/no-shell environments). curl on a json-locked session returns 409 — and json on a curl-locked session also returns 409. Limits: 3MB/file, 10 files/request, 5MB total. Text files: send plain text (no encoding field). Binary files: pre-base64-encode and set encoding='base64' — otherwise the server rejects with 400 (binary detected). Batches exceeding these limits must use curl mode + create_archive instead. Retry: 4xx → fail immediately, 5xx → 1–2 retries, timeout → 1 retry. Every retry from a new create_session (new batch_id). Final failure response includes fallback_options (external_repo / deploy_project) — surface to user.