📦 배포

📦 Capgo에서 앱 배포를 위한 배ंडल 관리.

⬆️ 업로드

별명: u

npx @capgo/cli@latest bundle upload

⬆️ Upload a new app bundle to Capgo Cloud for distribution. Version must be > 0.0.0 and unique. Deleted versions cannot be reused for security. External option: Store only a URL link (useful for apps >200MB or privacy requirements). Capgo never inspects external content. Add encryption for trustless security.

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

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 Cloud에 업로드하지 않고 외부 URL로 연결하기
—iv-session-key	string	번들 URL 외부에 대한 IV 및 세션 키 설정
—s3-지역	string	S3 버킷의 지역
—s3-apikey	string	API S3 엔드포인트의 API 키
—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을 표준 출력으로 출력합니다.
—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	node_modules를 업로드할 때 메타데이터 확인을 무시합니다.
—ignore-checksum-check	boolean	업로드할 때 체크섬 확인을 무시합니다.
—force-crc32-checksum	boolean	업로드에 대한 CRC32 체크섬을 강제로 사용합니다. (자동 감지 오버라이드)
—timeout	string	업로드 프로세스의 타임아웃을 초 단위로 설정합니다.
—multipart	boolean	[deprecated] —tus를 사용하세요. S3 업로드에 multipart 프로토콜을 사용합니다.
—zip	boolean	배포를 Capgo cloud (legacy)에 업로드할 때 zip을 사용합니다.
—tus	boolean	Capgo 클라우드에 TUS를 사용하여 배ंडल을 업로드하세요.
—tus-chunk-size	string	TUS 재시작 업로드에 사용되는 바이트 단위의 블록 크기 (기본값: 자동)
—partial	boolean	[deprecated] —delta를 사용하세요. 빠른 업데이트를 위해 incremental 업데이트만 업로드하세요.
—partial-only	boolean	[deprecated] —delta-only를 사용하세요. incremental 업데이트만 업로드하고 전체 배ंडल은 건너 뛰세요.
—delta	boolean	빠른 업데이트를 위해 instant, super fast 업데이트를 위해 변경된 파일만 업로드하세요.
—delta-only	boolean	전체 배ंडल 없이 delta 업데이트만 업로드하여 최대 속도 (대형 앱에 유용)를 얻으세요.
—no-delta	boolean	Direct Update를 사용하더라도 델타 업데이트를 비활성화합니다.
—encrypted-checksum	string	업로드할 외부 번들을 올릴 때만 사용하는 암호화된 체크섬(서명).
—auto-set-bundle	boolean	capacitor.config.json에서 번들을 자동으로 설정합니다.
—dry-upload	boolean	Dry upload the bundle process, mean it will not upload the files but add the row in database (Used by Capgo for internal testing)
—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	브로틀리 압축에서 제외할 파일 (쉼표로 구분된 glob, 예: “.jpg, .png”)—disable-brotli업데이터 버전이 지원하는 경우에도 브로틀리 압축을 완전히 비활성화
—version-exists-ok	boolean	CI/CD 워크플로우에서 모노레포를 위한 버전이 이미 존재할 경우 성공적으로 종료
—encrypt-partial	boolean	업데이트 파일을 부분 암호화 (업데이터 > 6.14.4부터 자동 활성화)
—self-assign	boolean	이 장치가 자동으로 이 채널에 가입할 수 있도록 허용합니다 (채널 설정 업데이트)
—supa-host	string	자체 호스팅 또는 개발을 위해 사용하는 커스텀 Supabase 호스트 URL (Capgo )
—supa-anon	string	자체 호스팅을 위해 사용하는 커스텀 Supabase anon 키
—verbose	boolean	세부 로깅과 함께 자세한 로그 출력을 활성화합니다

🧪 호환성

npx @capgo/cli@latest bundle compatibility

🧪 Capgo에서 특정 채널과 버블의 호환성을 확인하여 업데이트가 안전한지 확인하세요.

예시:

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

옵션:

Param	Type	설명
-a,	string	API 계정에 연결하기 위한 키
-c,	string	호환성을 확인할 채널
—텍스트	boolean	이모티콘 대신 출력 텍스트
—패키지-JSON	string	모노레포의 패키지 JSON 파일 경로 (쉼표로 구분)
—노드-모듈	string	모노레포의 노드 모듈 디렉토리 경로 (쉼표로 구분)
—수파베이스-호스트	string	수파베이스 호스트 URL (자체 호스팅 또는 개발용 Capgo)
—수파베이스-어노	string	수파베이스 어노 키 (자체 호스팅용)

🔹 릴리즈 타입

npx @capgo/cli@latest bundle releaseType

🧭

Example:

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

Options:

Param	Type	Description
-a,	string	API key
-c,	string	__CAPGO_KEEP_0__
—package-json	string	__CAPGO_KEEP_0__
—node-modules	string	__CAPGO_KEEP_0__
—supa-host	string	Capgo
—supa-anon	string	__CAPGO_KEEP_0__

🗑️ 삭제

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Capgo Cloud에서 특정 번들 삭제하기, 옵션으로 단일 버전을 대상으로 할 수 있습니다.

예시:

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

옵션:

Param	Type	설명
-a,	string	API 키를 클릭하여 계정에 연결하세요.
—supa-host	string	Capgo 자체 호스팅 또는 개발을 위해 사용하는 Custom Supabase 호스트 URL입니다.
—supa-anon	string	__CAPGO_KEEP_0__ 자체 호스팅을 위해 사용하는 Custom Supabase anon 키입니다.

📋 목록

Alias: l

npx @capgo/cli@latest bundle list

📋 Capgo Cloud에서 앱에 업로드한 모든 패키지를 목록화합니다.

예시:

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

옵션:

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

🧹 __CAPGO_KEEP_0__

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Capgo 클라우드에서 Capgo 개의 최근 버전을 제외한 이전 버전의 번들들을 삭제합니다. 채널과 연결된 번들은 —ignore-channel 옵션을 사용하는 경우 제외됩니다.

예시:

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

옵션:

파라미터	타입	설명
-b,	string	삭제할 앱의 버전 번호
-a,	string	API 계정에 연결하는 키
-k,	string	보존할 버전 수
-f,	string	강제 삭제
—ignore-channel	boolean	링크된 채널까지 삭제 (경고: 채널도 삭제)
—supa-host	string	Capgo 개인 호스팅 또는 개발을위한 커스텀 Supabase 호스트 URL
—supa-anon	string	__CAPGO_KEEP_0__ 개인 호스팅을위한 커스텀 Supabase anon 키

🔒 암호화

npx @capgo/cli@latest bundle encrypt

🔒 외부 저장소에 안전하게 저장하기 위해 zip 패키지를 암호화합니다. 업로드/복호화에 사용할 ivSessionKey를 반환합니다. 'bundle zip —json'을 사용하여 체크섬을 가져옵니다.

예시:

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

옵션:

파라미터	타입	설명
—키	string	사설 서명 키의 사용자 지정 경로
—키-데이터	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

옵션:

Param	Type	설명
—key	string	사용자 지정 경로에 개인 서명 키
—key-data	string	개인 서명 키
—checksum	string	배달의 요새의 무결성을 확인하기 위해 배달의 요새의 무결성을 확인하기 위한 체크섬
—package-json	string	패키지 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-체크	boolean	code의 소스 및 인덱스 루트 폴더에 있는지 확인하지 않음
—key-v2	boolean	암호화 v2 사용
—package-json	string	모노레포의 package.json 파일 경로 (쉼표로 구분)

번들에서 계속

번들에서 계속하는 경우 bundle 보안 및 규정 준수 계획을 위해 연결하세요. 암호화 __CAPGO_KEEP_0__ 암호화 구현 세부 사항에 대해. 규정 준수 __CAPGO_KEEP_0__ 규정 준수 구현 세부 사항에 대해. Capgo 보안 스캐너 Capgo 보안 스캐너 제품 워크플로에 대해. Capgo 보안 Capgo 보안 제품 워크플로에 대해. Capgo 신뢰 센터 Capgo 신뢰 센터 제품 워크플로에 대해.