Zinnector®를 사용한 배포: 연결, 확인, 푸시

프로젝트가 로컬에서 실행되면 네 가지 명령어를 통해 Zinn Digital® 호스팅의 라이브 사이트로 이전할 수 있습니다. 즉 로그인, 프로젝트를 호스팅 슬롯에 연결, 사전 점검(pre-flight) 확인, 푸시입니다. 이 문서에서는 각 명령어와 출력 내용, 그리고 이후에 사용할 명령어인 재배포, 배포 내역, 빌드 로그를 살펴봅니다.

API 키로 로그인

대시보드의 설정 → API 키에서 키를 생성한 후 다음을 실행하십시오.

zinnector login

키는 프롬프트에 입력해야 합니다. 명령줄에서는 절대로 허용되지 않으므로 셸 기록이나 프로세스 목록에 남지 않습니다. CI에서는 echo "$ZINN_API_KEY" | zinnector login --profile ci와 같이 파이프로 전달하거나 ZINNECTOR_TOKEN을 설정하여 login을 완전히 건너뛰십시오. 키는 저장되기 전에 유효성 검사를 거치며 600 파일 모드로 저장됩니다. zinnector whoami --scopes는 로그인한 조직과 키가 가진 권한을 표시하며 샌드박스 키는 샌드박스 키로 표시됩니다.

슬롯에 프로젝트 연결

zinnector link                                   # 목록에서 사이트 선택
zinnector link example.com --repo acme/site --branch main

link는 사이트의 id를 zinnector.json에 기록하며, --no-repo를 전달하지 않는 한 프로젝트의 git 원격 저장소를 플랫폼의 사이트에 연결하여 푸시 시 배포되도록 합니다. zinnector.json을 커밋하십시오. 그러면 저장소를 복제한 동료가 별도의 안내 없이도 동일한 위치로 배포할 수 있습니다. 이 파일에는 비밀 정보가 포함되지 않습니다.

사전 점검(pre-flight) 확인

zinnector check

이 명령어는 CLI가 존재하는 이유입니다. 배포 대상 슬롯과 프로젝트를 비교하여 모든 불일치 사항과 비교할 수 없었던 모든 항목을 출력합니다.

• PHP 버전: 메이저 버전 차이는 사이트를 확실히 망가뜨리므로 높음으로 평가되며, 모든 것을 심각으로 분류하면 사용자가 경고를 무시하게 되므로 마이너 차이는 더 낮게 평가됩니다.
• 슬롯이 빌드한 버전으로 전환 가능한지 여부, 슬롯의 PHP가 지원 종료(end of life)를 지났는지 여부, 머신이 해당 버전을 적용했는지 아니면 단순히 전달만 받았는지 여부.
• 슬롯에 실제로 남아 있는 디스크 및 inode 여유 공간 대비 프로젝트의 크기와 파일 수 — WordPress 트리는 디스크 한도에 훨씬 못 미치더라도 파일 수가 부족해질 수 있습니다.
• 양쪽의 WordPress 버전, 슬롯의 프로비저닝 완료 여부, 푸시할 저장소 연결 여부.

이 명령어는 경고할 뿐 배포를 차단하지는 않습니다. 검사기가 알지 못하는 본인 사이트만의 정보를 사용자가 알고 있으므로 모든 결과는 zinnector push --force로 재정의할 수 있습니다. 비교할 수 없는 항목은 통과가 아닌 알 수 없음으로 보고되며 요약에는 항상 그 수가 표시됩니다. 기본적으로 로컬 PHP 버전은 zinnector.json에 선언된 버전입니다. 대신 --probe를 사용하면 로컬 런타임을 부팅하여 측정합니다. --strict는 CI 게이트가 요구하는 방식대로 알 수 없는 항목에 대해서도 0이 아닌 값으로 종료합니다.

푸시

zinnector push

push는 사전 점검을 실행하고 커밋을 푸시하며 배포를 트리거한 후 완료될 때까지 지켜보면서 최종 상태와 배포된 커밋을 출력합니다. --dry-run은 배포를 제외한 모든 작업을 수행하고, --no-wait는 배포를 트리거한 후 종료하며, --no-git은 푸시하지 않고 플랫폼에 이미 있는 내용을 배포합니다. 배포된 커밋이 방금 푸시한 커밋이 아닌 경우 이를 알려줍니다.

문제가 발생한 경우

zinnector deploys example.com        # 배포 내역 — 상태, 커밋, 트리거, 메시지
zinnector logs example.com --build   # 가장 최근 배포의 빌드 로그
zinnector logs example.com --error   # 사이트의 오류 로그
zinnector deploy example.com         # 플랫폼에 이미 있는 항목 재배포
zinnector ai "why is my deploy failing?"

zinnector ai는 플랫폼에서 본인의 계정을 대상으로 실행되므로 동일한 배포 내역과 로그를 확인할 수 있습니다. 프로젝트 내부에서 실행하면 디렉터리 이름, 버전, 사이트 id 등 프로젝트의 구조를 전송하며 파일 내용은 절대로 전송하지 않습니다.

관련 문서

• 시작하기 · 로컬 개발 · 명령어 참조 · 문제 해결