알리바바 클라우드 정적 사이트 배포 (Aliyun Static Site Deploy)
핵심 규칙
- EMAS Serverless 정적 호스팅을 기본적인 초보자용 무도메인 미리보기 경로로 취급합니다. 사용자에게 알리바바 기본 URL을 제공하고 일반적인 OSS 기본 도메인 다운로드 문제를 방지합니다.
- OSS + GitHub Actions는 사용자가 명시적으로 GitHub-to-알리바바 자동화를 원하고, OSS 버킷을 생성했거나 생성할 수 있으며, 최종 URL이 인라인 HTML로 열리는지 확인해야 한다는 점을 이해한 경우에만 반복 가능한 자동화 경로로 간주합니다.
- 알리바바 로그인, 실명 인증, 유료 서비스 활성화, AccessKey 생성, GitHub 2FA 또는 결제 확인이 자동화될 수 있다고 가정하지 마십시오. 중단하고 사용자에게 해당 단계를 완료하도록 요청하십시오.
- 사용자에게 채팅으로
ALIYUN_ACCESS_KEY_SECRET, GitHub 토큰, 비밀번호 또는 결제 스크린샷을 붙여넣도록 요청하지 마십시오. GitHub Secrets 또는 알리바바/GitHub UI에 직접 비밀 정보를 입력하도록 요청하십시오.
첫 번째 결정
배포 코드를 작성하기 전에 경로를 결정하고 명시적으로 말하십시오:
| 경로 | 사용 시기 | 자동화 수준 | 위험 |
|---|---|---|---|
| EMAS 정적 호스팅 | 커스텀 도메인 없음, 초보자 미리보기, 사용자가 알리바바 콘솔 조작 가능 | 에이전트가 파일을 준비하고 콘솔 단계를 안내함; 필요한 경우 사용자가 로그인/결제/업로드 처리 | 콘솔 UI가 변경될 수 있고 수동 업로드가 필요할 수 있음 |
| OSS 워크플로우 | 사용자가 Codex X GitHub X 알리바바 자동화를 원함; OSS 버킷 및 AccessKey 준비 가능 | 에이전트가 워크플로우를 생성하고, 코드를 푸시하고, CI를 트리거하고, URL을 확인할 수 있음 | OSS 기본 도메인은 메타데이터/정적 호스팅이 올바르지 않으면 HTML을 다운로드할 수 있음 |
사용자가 "没有域名先给客户看" (도메인 없이 먼저 고객에게 보여줌) 라고만 말하면 먼저 EMAS 안내를 사용하십시오. 사용자가 "自动上线" (자동 온라인), "XgitX阿里云" (git과 알리바바), "GitHub 自动部署" (GitHub 자동 배포), 또는 "以后反复更新" (이후 반복 업데이트) 라고 말하면 OSS 워크플로우 스크립트를 사용하지만 진행하기 전에 브라우저 다운로드 확인 위험을 설명하십시오.
워크플로우
- 프로젝트 검사:
python3 /Users/likai/.codex/skills/aliyun-static-site-deploy/scripts/check_readiness.py --project . - 한 문장으로 배포 경로 설명:
- OSS: "GitHub Actions를 사용하여 알리바바 OSS에 업로드하고 브라우저가 파일을 다운로드하지 않는지 확인합니다."
- EMAS: "먼저 알리바바 EMAS 정적 호스팅을 사용하여 도메인 없는 미리보기 URL을 얻습니다."
- 사용자가 알리바바 액세스를 준비하지 않은 경우
references/secrets-hand-off.md를 읽고 알리바바 로그인/결제/AccessKey/GitHub Secrets를 완료하도록 요청하십시오. 클릭 위치를 설명할 때 번들된 스크린샷을 사용하십시오. - OSS 자동화의 경우에만 GitHub Actions 워크플로우 생성:
python3 /Users/likai/.codex/skills/aliyun-static-site-deploy/scripts/prepare_oss_workflow.py --project . --force - 생성된 워크플로우와 로컬 프로젝트를 다시 확인:
python3 /Users/likai/.codex/skills/aliyun-static-site-deploy/scripts/check_readiness.py --project . --strict - 사용자가 요청하고 자격 증명을 사용할 수 있는 경우 프로젝트를 GitHub에 커밋/푸시합니다. Git LFS가 잘못 설치된 경우 스크립트 출력을 사용하여 수정 방법을 설명하고 맹목적으로 재시도하지 마십시오.
- 배포가 완료된 후 공개 URL 확인:
python3 /Users/likai/.codex/skills/aliyun-static-site-deploy/scripts/verify_deployed_url.py "$ALIYUN_SITE_URL"
필수 GitHub Secrets
포함된 OSS 워크플로우의 경우 사용자에게 GitHub에서 다음 저장소 시크릿을 생성하도록 요청하십시오:
ALIYUN_ACCESS_KEY_IDALIYUN_ACCESS_KEY_SECRETALIYUN_OSS_BUCKETALIYUN_OSS_ENDPOINT
선택 사항:
ALIYUN_SITE_URL: 배포 시간 확인용. 예:https://your-bucket.oss-cn-hangzhou.aliyuncs.com/index.html
EMAS의 경우 해당 프로젝트의 EMAS 배포 스크립트에 필요한 정확한 시크릿 이름을 사용하십시오. EMAS 스크립트가 없으면 가짜 시크릿 이름을 만들지 말고; 공식 API/SDK 경로를 확인한 후 사용자를 수동 EMAS 정적 호스팅 업로드로 안내하거나 프로젝트별 스크립트를 생성하십시오.
인간 경계
다음 사항이 누락된 경우 중단하고 사용자를 호출하십시오:
- 알리바바 계정에 로그인하지 않았거나, 실명 인증이 되지 않았거나, 결제를 요청하는 경우.
- EMAS 서비스 공간, OSS 버킷 또는 정적 호스팅이 생성되지 않은 경우.
- AccessKey가 생성되지 않은 경우.
- GitHub Secrets가 채워지지 않은 경우.
- GitHub에서 사용자 이름/토큰 또는 2단계 인증을 요청하는 경우.
사용자에게 정확히 입력해야 할 필드를 보여주되, 채팅에서 시크릿을 받지 마십시오.
배포 성공 기준
모든 검사가 통과될 때까지 배포가 완료되지 않은 것으로 처리하십시오:
- GitHub 저장소에 커밋된 웹사이트 소스와 배포 지침이 있어야 합니다.
- OSS 자동화의 경우 GitHub 저장소에
.github/workflows/deploy-aliyun-static-site.yml에 생성된 워크플로우가 있고main또는workflow_dispatch에서 Actions 실행이 성공해야 합니다. - EMAS 수동/정적 호스팅 업로드의 경우 알리바바 콘솔에 업로드된 홈페이지 파일과 공개 기본 URL이 표시되어야 합니다.
- 공개 URL이 HTTP 200 또는 3xx 후 200을 반환해야 합니다.
- 응답이 HTML이어야 하며, XML 오류 텍스트 또는 강제 다운로드 메타데이터가 아니어야 합니다.
- 페이지에
<html및 비어 있지 않은 제목 또는 표시 가능한 본문 텍스트가 포함되어야 합니다. - 홈페이지에서 참조하는 주요 자산이 공개 또는 원격 URL이어야 합니다.
참조
- 단계별 알리바바/GitHub Secrets 도움이 필요한 경우
references/secrets-hand-off.md를 읽으십시오. - 배포 또는 URL 확인이 실패한 경우
references/troubleshooting.md를 읽으십시오.