CCD CLI(커맨드 라인 인터페이스)
Use the command-line interface to manage Cloud Content Delivery buckets, entries, and release pipelines efficiently.
읽는 시간 1분최근 업데이트: 5달 전
CCD CLI(커맨드 라인 인터페이스)는 CCD(Cloud Content Delivery)와 상호 작용하는 데 권장되는 방법입니다. 이 툴을 사용하면 커맨드 라인을 사용하여 파일 관리부터 릴리스 파이프라인 구성까지 프로젝트의 모든 측면을 제어할 수 있습니다. 대시보드에서 많은 유사한 기능을 수행할 수 있지만 버킷에 파일을 복사하거나 전체 폴더를 동기화하려면 CLI를 사용해야 합니다.
시작하기
CLI용 CCD를 설정하려면 다음을 수행합니다.-
이미 프로젝트가 있는 경우 다음 단계로 이동합니다. 그렇지 않고 처음으로 Unity 서비스를 사용하는 경우에는 다음을 수행합니다.
- Unity ID 계정을 만듭니다(아직 계정이 없는 경우).
- Unity Dashboard에 로그인합니다.
- Projects 드롭다운을 클릭한 다음 Create project를 클릭합니다. Create project 창에서 필수 세부 정보를 입력합니다.
- 대시보드의 Main Menu에서 Explore Services를 클릭합니다(아직 선택하지 않은 경우).
- 메인 창의 All Solutions 또는 LiveOps 탭 아래에서 Cloud Content Delivery를 클릭합니다.
- 왼쪽에서 Download CLI를 클릭합니다.
- CLI를 다운로드하려면 운영체제 버전을 찾은 다음 다운로드 아이콘을 선택합니다.
- 왼쪽 내비게이션에서 API Key 섹션으로 이동합니다.
- API 키를 복사합니다.
- 콘텐츠를 업로드하는 머신에서 CLI를 실행합니다.
-
커맨드를 통해 API 키를 사용하여 CLI에 로그인합니다.
auth
CLI 활용법
CLI에서 CCD 커맨드의 기본 형태는 다음과 같습니다.$ ucd [command]팁
해당 커맨드에 대해 사용 가능한 추가 파라미터와 플래그를 표시하려면 커맨드 끝에 또는 를 입력해야 합니다.
-h--help--version$ ucd --version- : Content Delivery에 액세스하기 위한 사용자 지정 API 키입니다.
--apikey string - ,
-h: 해당 커맨드에 대한 추가 파라미터와 플래그를 표시합니다.--help - ,
-q: 지정된 커맨드로 수행된 작업의 표시를 비활성화합니다.--quiet - ,
-v: 오류 정보를 표시합니다.--verbose
참고
0.11.0보다 큰 CLI 버전의 경우 대부분의 커맨드에 플래그를 추가해야 합니다. CLI 샘플 및 CLI를 통해 CCD 사용을 참고하십시오.
--environmentauth
CCD로 인증합니다. 활용법:ucd auth [command]- : 현재 사용자 정보를 표시합니다.
info - : 로그인하여 프로젝트 데이터와 콘텐츠 제공 서비스에 액세스합니다.
login [apikey] - : 현재 계정에서 로그아웃합니다.
logout
배지
릴리스의 배지를 관리합니다. 활용법:ucd badges [command]- : 릴리스할 배지를 추가합니다.
add [badge_name] [release_id] - : 현재 버킷의 배지를 나열합니다.
list - : 배지를 제거합니다.
remove [badge_name]
버킷
프로젝트의 버킷을 관리합니다. 활용법:ucd buckets [command]- : 프로젝트의 버킷을 생성합니다.
create [project_guid] [bucket name] - : 버킷을 삭제합니다.
delete [bucket_id] - : 버킷 정보를 가져옵니다.
info [bucket_id] - : 프로젝트의 버킷을 나열합니다.
list [project_guid]
config
현재 버킷을 설정하고 식별하기 위한 옵션을 관리합니다. 활용법:ucd config [command]- : 모든 로컬 구성 옵션을 지웁니다.
clear - : 개발 환경을 현재로 설정합니다.
set environment [environment_id] --project=[project_id] - : 지정된 버킷을 현재(활성) 버킷으로 설정합니다.
set bucket [bucket_id] [flags] - : 현재 로컬 구성을 표시합니다.
show
엔트리
현재 버킷의 엔트리를 관리합니다. 활용법:ucd entries [command]- : 로컬 파일의 현재 버킷에서 엔트리를 생성합니다.
copy [local_path] [entry file name] - : 현재 버킷의 엔트리를 삭제합니다.
delete [entry file name] - : 현재 버킷에서 엔트리 콘텐츠를 다운로드합니다.
download [entry file name] - : 현재 버킷에서 엔트리 정보를 가져옵니다.
info [entry file name] - : 현재 버킷의 엔트리를 나열합니다.
list - : 현재 버킷의 로컬 디렉토리에서 엔트리를 동기화합니다.
sync [local_dir_path] - : 현재 버킷의 엔트리를 업데이트합니다.
update [entry file name]
팁
엔트리 동기화 커맨드를 취소하려면 프로세스 중에 Ctrl+C를 누르십시오. 취소 전에 동기화된 모든 엔트리는 업로드된 상태로 유지되므로 버킷에서 삭제해야 합니다.
릴리스
현재 버킷의 릴리스를 관리합니다. 활용법:ucd releases [command]- : 현재 버킷의 최신 버전에서 릴리스를 생성합니다.
create - : 특정 릴리스의 릴리스 정보를 가져옵니다.
info [release_id] - : 현재 버킷의 릴리스를 나열합니다.
list - : 특정 릴리스를 다른 버킷으로 승격합니다.
promote [release_id] --target_bucket [bucket_id],-n플래그(선택 사항)는 노트 문자열을 추가합니다.--notes - : 기존 릴리스를 업데이트합니다.
update [release_id],-n플래그(선택 사항)는 노트 문자열을 추가합니다.--notes
참고
bucket_namebucket_IDbuckets listCLI 예시
- 버킷을 생성하려면 다음을 수행합니다.
$ ucd buckets create [project_id] [bucket_name] - 버킷을 삭제하려면 다음을 수행합니다.
$ ucd buckets delete [bucket_id] - 를 포함하여 프로젝트의 모든 버킷을 나열하려면 다음을 수행합니다.
bucket_id
$ ucd buckets list [project_id] - 현재 버킷을 활성 버킷으로 설정하려면 다음을 수행합니다.
$ ucd config set bucket [bucket_id] - 로컬 폴더를 현재 버킷과 동기화하려면 다음을 수행합니다.
$ ucd entries sync [local_dir_path] - 현재 버킷의 모든 엔트리 목록을 보려면 다음을 수행합니다.
$ ucd entries list
참고
0.11.0보다 큰 CLI 버전의 경우 대부분의 커맨드에 플래그를 추가해야 합니다.예시: 개발 환경 커맨드를 사용하여 향후 모든 커맨드에 사용할 개발 환경을 저장할 수도 있습니다.에서 개발 환경을 설정하면 플래그를 추가할 필요가 없습니다.
--environmentucd buckets list --environment=[environment_id] [PROJECT_ID]configucd config set environment [environment_id] --project=[project_id]config--environment