Studio CLI

Studio CLI란?

Studio CLI는 터미널에서 WordPress Studio 기능과 상호작용하는 전역 명령줄 유틸리티입니다. Studio 데스크톱 앱이 닫혀 있어도 작동하도록 설계되었으며, 로컬 Studio 사이트와 WordPress.com에서 호스팅되는 프리뷰 환경을 관리하는 데 사용됩니다.

CLI는 Studio와 함께 설치할 수 있으며(번들로 포함), wp-studio라는 독립 npm 모듈로도 사용할 수 있습니다. 핵심 목적은 스크립트와 빌드 단계에서 프리뷰 사이트 생성, 업데이트, 인증 등의 Studio 관련 작업을 제어하는 것입니다.

주요 기능

• 전역 터미널 명령 (studio): Studio를 열어둘 필요 없이 어디서나 Studio 관련 작업 실행.
• 구조화된 명령 구문 (studio <area> <command> [options]): 사이트 및 프리뷰 워크플로에 예측 가능한 패턴 적용.
• 경로 지정 (--path): 현재 작업 디렉터리가 아닌 특정 Studio 사이트 디렉터리를 명령에 지정.
• WordPress.com 인증 관리: studio auth login, studio auth logout, studio auth status를 사용하여 필요한 경우 CLI 작업을 인증된 WordPress.com 계정에 연결.
• 프리뷰 사이트 작업: studio preview create, studio preview list, studio preview update, studio preview delete 등의 명령으로 WordPress.com에서 임시 공유 프리뷰 사이트 생성, 나열, 업데이트, 삭제.
• 로컬 사이트 관리 명령: studio site ... 명령으로 터미널에서 로컬 Studio 사이트(상태, 생성, 나열, 시작, 중지, 삭제, 구성) 관리.

Studio CLI 사용 방법

1. Studio 앱에서 Studio CLI 활성화 (Studio를 이미 사용하는 경우 권장):

   • “WordPress Studio” 애플리케이션 열기.
   • 메인 메뉴에서 설정 모달 열기(또는 톱니바퀴 아이콘 클릭).
   • “Studio CLI” 활성화 후 저장 클릭.
   • macOS에서는 설치 허용을 위해 계정 암호 입력 요청될 수 있음.

2. 터미널 열고 사용 가능 여부 확인:

   • studio --help로 개요 확인.

3. WordPress.com 액세스가 필요한 작업(예: 프리뷰 사이트)에 인증:

   • studio auth login 실행.
   • 브라우저 기반 흐름이 열리며, 터미널에 붙여넣을 인증 토큰 수령.
   • studio auth status로 확인.

4. 로컬 Studio 사이트에서 프리뷰 사이트 생성 및 공유:

   • 로컬 Studio 사이트 루트에서 실행:

     cd /path/to/your/studio-site
     studio preview create
     

   • CLI가 로컬 사이트를 빌드 및 업로드하여 프리뷰 환경 생성 후 공유할 프리뷰 URL 반환.

5. 프리뷰 호스트 이름으로 프리뷰 업데이트 또는 삭제:

   • studio preview list로 host 식별자 확인.
   • 업데이트:

     studio preview update <host>
     

   • 삭제:

     studio preview delete <host>
     

6. 필요 시 다른 사이트 디렉터리 지정:

   • 디렉터리 변경 대신 명령에 --path /path/to/site 추가:

     studio preview create --path /path/to/your/studio-site
     

사용 사례

• 터미널에서 로컬 Studio 사이트 관리: 스크립트 중심 워크플로에서 studio site status, studio site start, studio site stop, studio site list로 로컬 환경 제어.

• 팀원 또는 이해관계자와 공유할 프리뷰 환경 생성: 로컬 Studio 사이트 루트에서 studio preview create 실행으로 WordPress.com에서 호스팅되는 임시 공유 프리뷰 URL 생성.

• 변경 사항 반영 시 프리뷰 반복: 초기 프리뷰 생성 후 studio preview update <host>로 로컬 사이트 변경 사항을 기존 프리뷰 환경에 재빌드 및 재배포.

• 프리뷰 환경 정리: 더 이상 필요 없을 때 studio preview delete <host>로 프리뷰 사이트 영구 삭제.

• 빌드 단계에서 Studio 워크플로 자동화: 스크립트에서 studio 명령으로 프리뷰 생성/업데이트, 사이트 관리 등의 작업을 개발 파이프라인에 통합.

자주 묻는 질문

Studio CLI를 사용하려면 Studio 데스크톱 앱을 열어둬야 하나요? 아니요. Studio CLI는 Studio가 열려 있지 않아도 터미널에서 Studio 기능과 상호작용하도록 설계되었습니다.

명령을 특정 Studio 사이트 디렉터리에 지정하려면? 대부분 명령은 Studio 관리 사이트 루트에서 실행된다고 가정합니다. 그렇지 않으면 --path 옵션 사용(예: studio preview create --path /path/to/site).

로그아웃 상태에서 프리뷰 명령을 실행하면? 인증이 필요한 명령(예: studio preview create)은 오류를 반환하고 로그인 안내.

업데이트/삭제에 사용할 프리뷰 호스트 이름을 어떻게 찾나요? studio preview list로 연결된 프리뷰와 host 값 확인. 이를 studio preview update <host> 또는 studio preview delete <host>에 사용.

studio auth login의 인증 정보는 어디서 오나요? 로그인 명령이 브라우저 기반 흐름을 시작하여 CLI를 WordPress.com 계정에 연결한 후, 터미널에 붙여넣을 인증 토큰 제공.

대안

• 수동 Studio UI 워크플로: 터미널 자동화가 필요하지 않다면, Studio 애플리케이션을 직접 사용해 CLI 통합 없이 프리뷰 생성과 로컬 사이트 제어를 처리할 수 있습니다.
• 일반 WordPress 명령줄 도구 (예: WP-CLI + 사용자 지정 스크립팅): Studio 전용 프리뷰 환경이 필요하지 않은 경우, 명령줄 WordPress 도구와 자체 스크립트를 결합해 사이트 작업을 관리할 수 있지만, 프리뷰 호스팅과 Studio 전용 기능은 지원되지 않을 수 있습니다.
• 기타 로컬 WordPress 오케스트레이션 방법: Studio의 사이트 관리 명령 대신 다른 로컬 WordPress 설정(컨테이너화 또는 스크립트 기반)을 사용하고 프리뷰를 별도 배포 단계로 처리할 수 있지만, Studio CLI의 프리뷰/갱신/삭제 통합 워크플로와 Studio 관리 사이트를 잃게 됩니다.