📦 번들

📦 Capgo Cloud에서 배포를위한 앱 번들을 관리합니다. 업로드, 호환성 검사, 및 암호화가 포함됩니다.

⬆️ 업로드

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Capgo에 새로운 앱 번들을 업로드하여 배포하세요. 버전은 0.0.0보다 크고 고유해야 합니다. 삭제된 버전은 보안을 위해 재사용할 수 없습니다. 외부 옵션: URL 링크만 저장 (200MB 이상의 앱 또는 개인 정보 보호 요구 사항에 유용합니다). Capgo는 외부 콘텐츠를 검사하지 않습니다. 신뢰할 수 없는 보안을 위해 암호화를 추가하세요.

예시:

npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production

옵션:

파라미터	타입	설명
-a,	string	API 계정에 연결하기 위한 키
-p,	string	업로드할 폴더의 경로를 지정하지 않으면 capacitor.config에서 webDir를 사용합니다.
-c,	string	채널을 연결할
-e,	string	Capgo 클라우드에 업로드하는 대신 외부 URL로 연결
—iv-session-key	string	bundle URL 외부에 IV 및 세션 키 설정
—s3-region	string	S3 버킷의 지역
—s3-apikey	string	API S3 엔드포인트의 키
—s3-apisecret	string	API S3 엔드포인트의 비밀번호
—s3-endpoint	string	S3 엔드포인트 URL
—s3-bucket-name	string	AWS S3 버킷 이름
—s3-port	string	S3 엔드포인트 포트
—no-s3-ssl	boolean	S3 업로드에 SSL 사용하지 않기
—key-v2	string	사용자 지정 개인 서명 키 경로 (v2 시스템)
—key-data-v2	string	사용자 지정 개인 서명 키 (v2 시스템)
—bundle-url	boolean	배포 URL을 stdout로 출력합니다.
—no-key	boolean	인증 키를 무시하고 명령을 전송합니다.
—no-code-check	boolean	code 소스 및 인덱스 폴더 루트에 존재하는지 확인하지 않습니다.
—display-iv-session	boolean	업데이트를 암호화할 때 사용하는 IV 및 세션 키를 콘솔에 표시합니다.
-b,	string	업로드할 배포의 버전 번호를 지정합니다.
—link	string	외부 리소스에 연결합니다 (예: GitHub 릴리스)
—comment	string	이 버전에 대한 댓글, 릴리스 노트, 커밋 해시, 커밋 메시지 등이 될 수 있습니다.
—min-update-version	string	업데이트를 위해 필요한 최소 버전. 채널의 메타데이터에 자동 업데이트 옵션을 설정한 경우에만 사용됩니다.
—auto-min-update-version	boolean	자연 패키지에 따라 최소 업데이트 버전을 설정합니다.
—ignore-metadata-check	boolean	업로드 시 메타데이터(노드 모듈) 확인을 무시합니다.
—ignore-checksum-check	boolean	업로드 시 체크섬 확인을 무시합니다.
—force-crc32-checksum	boolean	업로드 시 CRC32 체크섬을 강제로 사용합니다(자동 감지 오버라이드)
—timeout	string	업로드 프로세스의 시간 초과 초
—multipart	boolean	[deprecated] —tus를 사용하세요. multipart 프로토콜을 사용하여 S3 업로드
—zip	boolean	Capgo 클라우드(legacy)에 zip을 사용하여 배포
—tus	boolean	Capgo 클라우드에 TUS를 사용하여 배포
—tus-chunk-size	string	TUS 재시도 업로드의 블록 크기(기본값: 자동)
—partial	boolean	[deprecated] —delta를 사용하세요. incremental 업데이트를 업로드
—부분만 업로드	boolean	[deprecated] —delta-only를 사용하세요. 전체 배포 대신 incremental 업데이트만 업로드하고 전체 배포를 건너뜁니다.
—delta	boolean	대량의 zip 다운로드 대신 빠른 업데이트를 위해 변경된 파일만 업로드하세요.
—delta-only	boolean	대량 앱을 위한 최대 속도 (useful for large apps)에서 전체 배포 없이 delta 업데이트만 업로드하세요.
—no-delta	boolean	Direct Update가 활성화되어도 delta 업데이트를 비활성화하세요.
—encrypted-checksum	string	외부 배포를 업로드할 때만 사용하는 암호화된 체크섬 (서명).
—auto-set-bundle	boolean	설정 파일인 capacitor.config.json에서 배포를 자동으로 설정하세요.
—dry-upload	boolean	Dry 업로드 프로세스를 수행하지 않습니다. 파일을 업로드하지 않고 데이터베이스에 행을 추가합니다. (내부 테스트를 위해 Capgo에 의해 사용됨)
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—encrypt-partial	boolean	델타 업데이트 파일을 암호화합니다. (업데이터 버전 6.14.4 이상일 경우 자동 활성화)
—delete-linked-bundle-on-upload	boolean	현재 업로드하려는 채널에서 연결된 번들을 찾고 삭제합니다
—no-brotli-patterns	string	브로틀리 압축에서 제외할 파일 (쉼표로 구분된 글로벌 패턴, 예: “”).jpg,.png
—disable-brotli	boolean	업데이트 버전이 지원하는 경우에도 브로틀리 압축을 완전히 비활성화합니다.
—version-exists-ok	boolean	빌드 버전이 이미 존재하는 경우 CI/CD 워크플로우와 함께 모노레포를 위한 성공적으로 종료합니다.
—self-assign	boolean	이 채널(업데이트 채널 설정)을 자동으로 가입하도록 장치에 허용합니다.
—supa-host	string	자체 호스팅 또는 개발을 위한 커스텀 Supabase 호스트 URL(Capgo)
—supa-anon	string	자체 호스팅을 위한 커스텀 Supabase anon 키
—verbose	boolean	verbose 모드 활성화 (상세 로깅 포함)

🧪 호환성

npx @capgo/cli@latest bundle compatibility

🧪 Capgo Cloud에서 특정 채널과 호환성을 확인하여 업데이트가 안전한지 확인합니다.

예시:

npx @capgo/cli@latest bundle compatibility com.example.app --channel production

옵션:

파라미터:	타입	설명
-a,	string	API 계정에 연결하기 위한 키
-c,	string	체크할 호환성 채널
—text	boolean	이모티콘 대신 텍스트 출력
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
—node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—supa-host	string	Capgo
—supa-anon	string	ReleaseType

🔹 터미널 창

npx @capgo/cli@latest bundle releaseType

터미널 창

복사

npx @capgo/cli@latest bundle releaseType com.example.app --channel production

옵션:

Param	Type	설명
-a,	string	API 계정에 연결하기 위한 키
-c,	string	비교할 채널
--package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)
--node-modules	string	모노레포의 node_modules 디렉토리 경로 (쉼표로 구분)
—supa-host	string	Capgo에서 사용하는 커스텀 수파베이스 호스트 URL (자체 호스팅 또는 개발용)
—supa-anon	string	__CAPGO_KEEP_0__에서 사용하는 커스텀 수파베이스 익명 키 (자체 호스팅)

🗑️ 삭제

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Capgo 클라우드에서 특정 번들 삭제 (선택적으로 특정 버전을 대상으로)

예시:

npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app

옵션:

Param	Type	설명
-a,	string	API 계정에 연결하기 위한 키
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	자체 호스팅을 위한 커스텀 Supabase anon 키

📋 목록

Alias: l

npx @capgo/cli@latest bundle list

Capgo 앱에 업로드 된 모든 번들을 목록화합니다.

예시:

npx @capgo/cli@latest bundle list com.example.app

옵션:

Param	Type	설명
-a,	string	API 키를 클릭하여 계정에 연결하세요.
—supa-host	string	사용자 지정 Supabase 호스트 URL (자체 호스팅 또는 Capgo 개발용)
—supa-anon	string	사용자 지정 Supabase anon 키 (자체 호스팅용)

🧹 Cleanup

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Capgo Cloud에서 지정된 최근 버전의 수를 유지하면서 삭제할旧 버전의 패키지를 삭제합니다. 채널에 연결된 패키지는 —ignore-channel 옵션을 사용하는 경우 제외됩니다.

예시:

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

옵션:

Param	Type	설명
-b,	string	앱 삭제할 버전 번호
-a,	string	API 계정에 연결하는 키
-k,	string	버전 수를 유지할 수
-f,	string	강제 삭제
—ignore-channel	boolean	채널과 연결된 경우에도 번들 삭제 (경고: 채널도 삭제)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	자체 호스팅을 위한 Supabase anon 키 (사용자 정의)

🔒 암호화

npx @capgo/cli@latest bundle encrypt

🔒 외부 저장소에 안전하게 업로드/복호화를 위해 zip 압축 파일을 암호화합니다. 업로드/복호화에 사용할 ivSessionKey를 반환합니다. 'bundle zip —json'을 사용하여 체크섬을 얻습니다.

예시:

npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

옵션:

Param	Type	설명
—key	string	사용자 지정 개인 암호화 키의 경로
—key-data	string	개인 서명 키
-j,	string	JSON 형식으로 출력
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)

🔓 해독

npx @capgo/cli@latest bundle decrypt

🔓 암호화된 번들을 해독 (주로 테스트 용도). 인증을 위한 base64 세션 키를 출력합니다.

예시:

npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM

옵션:

파라미터	타입	설명
—key	string	개인 서명 키의 사용자 지정 경로
—key-data	string	개인 서명 키
—checksum	string	배달물의 체크섬, 배달물의 무결성을 확인하기 위해
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)

🔹 압축 파일

npx @capgo/cli@latest bundle zip

🗜️ 앱 번들에 대한 zip 파일을 생성하세요. 암호화에 사용할 체크섬을 반환합니다. —json 옵션을 사용하여 기계가 읽을 수 있는 출력을 얻으십시오.

예시:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

옵션:

파라미터	타입	설명
-p,	string	capacitor.config에서 설정한 webDir를 사용하지 않으면 업로드할 폴더의 경로를 지정하세요.
-b,	string	zip 파일 이름으로 사용할 버전 번호를 지정하세요.
-n,	string	zip 파일 이름을 지정하세요.
-j,	string	JSON 형식으로 출력합니다.
--no-code-check	boolean	소스 code와 root 폴더 내 index가 존재하는지 확인하지 않습니다.
--key-v2	boolean	__CAPGO_KEEP_0__ 암호화 v2 사용
—package-json	string	다중 리포지토리용 package.json 파일 경로 (쉼표로 구분)

__CAPGO_KEEP_1__에서 계속

__CAPGO_KEEP_2__을 사용하고 있다면 __CAPGO_KEEP_2__을 사용하여 보안 및 규정 준수 계획을 수립하고, __CAPGO_KEEP_2__을 __CAPGO_KEEP_3__과 연결하세요. __CAPGO_KEEP_3__에서 암호화 구현 세부 정보를 참조하세요. __CAPGO_KEEP_4__에서 규정 준수 구현 세부 정보를 참조하세요. __CAPGO_KEEP_2__ __CAPGO_KEEP_2__ __CAPGO_KEEP_2__ Capgo 보안 스캐너 Capgo 보안 스캐너의 제품 워크플로우에 대해 Capgo 보안 Capgo 보안의 제품 워크플로우에 대해 Capgo 신뢰 센터 Capgo 신뢰 센터의 제품 워크플로우에 대해