본문 바로가기

커스텀 도메인

예를 들어 다음과 같은 자체 호스트네임을 사용하세요: updates.example.com앱의 Live Updates API 요청에 사용할 수 있으며, Capgo는 채널, bundle, rollout을 계속 관리합니다.

커스텀 도메인은 다음 플랜에서 사용할 수 있습니다: Enterprise 플랜. 조직 관리자는 Console에서 Live Updates API 호스트네임을 추가하고, 제공된 DNS 레코드를 게시한 뒤 활성화 상태를 확인할 수 있습니다.

1. 커스텀 도메인 추가

“1. 커스텀 도메인 추가” 섹션
  1. 다음을 엽니다: Capgo 콘솔 그리고 조직을 선택하세요.
  2. 다음으로 이동: 설정 → 조직 → 일반 에서 커스텀 도메인을(를) 찾으세요. 도메인을 추가하려면 조직 설정 업데이트 권한과 활성 Enterprise 플랜이 필요합니다.
  3. 와 같은 호스트명을 입력하세요. updates.example.com, https://, 경로, 와일드카드 없이.
  4. 클릭 도메인 추가. 콘솔에는 게시할 DNS 레코드와 검증 대기 중 상태가 표시됩니다.

조직당 Live Updates API 호스트명을 하나만 설정할 수 있습니다. 해당 DNS 레코드를 편집할 수 있어야 합니다.

만약 사용자 지정 도메인 옵션을 사용할 수 없다면, Enterprise 지원 담당자에게 문의하거나 support@capgo.app 으로 조직, 앱 ID, 원하는 호스트명 및 DNS 제공업체 정보를 보내 주세요. 설정 전에 특정 데이터 거주 지역 이나 bundle 다운로드용 사용자 지정 호스트명이 필요하면 지원팀에 미리 문의해 주세요.

2. DNS 설정 및 HTTPS 확인

“2. DNS 설정 및 HTTPS 확인” 섹션

DNS 제공업체에서 Console에 표시되거나 지원팀이 제공한 레코드를 추가하세요. CNAME과 소유권 또는 인증서 검증 TXT 레코드를 포함해 레코드 유형, 이름, 값을 정확히 복사하세요. Console에서 값을 클릭하면 복사됩니다. Cloudflare DNS를 사용한다면 CNAME을 DNS만 유지하세요. 지원팀에서 다른 설정을 안내한 경우는 예외입니다.

CNAME만으로 충분하다고 가정하지 말고, 제공된 타겟을 사용하세요. plugin.capgo.app 도메인을 사용하는 동안 DNS 레코드를 그대로 유지하세요.

DNS 전파가 완료되면 다음을 클릭하세요: 상태 새로고침. Console에서는 활성 hostname과 HTTPS 인증서가 모두 활성화된 경우에만 표시되며, 그런 다음 제공합니다 업데이터 설정 복사. 지원팀의 도움을 받아 설정하는 경우, 지원팀에 활성화 확인을 요청하세요. 다음 명령으로 DNS를 확인하고 TLS 연결을 점검할 수도 있습니다:

터미널 창
dig updates.example.com
curl -v https://updates.example.com/updates

교체 updates.example.com 프로비저닝된 hostname으로. curl 명령어는 DNS, TLS, HTTP 연결을 확인합니다. 다음에 대한 GET 요청은 /updates 유효한 업데이트 확인이 아니며 API 오류를 반환할 수 있습니다. 4단계에서 네이티브 테스트 build로 실제 업데이트 흐름을 검증하세요.

도메인이 활성화되면 콘솔에서 업데이트 설정을 복사하고 세 가지 URL을 모두 다음에 병합하세요. capacitor.config.ts. 표준 Capgo API 경로로 프로비저닝된 호스트네임의 경우 다음을 사용하세요:

import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = {
appId: 'com.example.app',
appName: 'My App',
webDir: 'dist',
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground',
updateUrl: 'https://updates.example.com/updates',
statsUrl: 'https://updates.example.com/stats',
channelUrl: 'https://updates.example.com/channel_self',
},
},
};
export default config;

예시 URL을 콘솔에 표시된 정확한 URL 또는 지원팀이 확인한 URL로 교체하세요. 기존 앱 설정 및 기타 플러그인 옵션은 유지하세요.

설정목적
updateUrl사용 가능한 번들을 확인합니다.
statsUrl업데이트 통계를 보고합니다.
channelUrl기기 채널 작업을 처리합니다.

4. 동기화, 테스트, 릴리스

“4. 동기화, 테스트 및 릴리스” 섹션

설정을 네이티브 프로젝트에 동기화하세요:

터미널 창
npx cap sync

네이티브 테스트 버전을 빌드하고 설치한 다음:

  1. 테스트 번들을 테스트 채널 에 일반적인 Capgo 워크플로우를 사용하여 업로드하세요.
  2. 네이티브 디바이스 로그를 확인해 업데이트 요청이 커스텀 호스트명에 도달하고 bundle이 정상적으로 다운로드 및 설치되는지 검증하세요.
  3. Console에 업데이트 통계가 표시되는지 확인하고, 앱에서 채널을 사용한다면 채널 작업을 테스트하세요.
  4. 평소 사용하는 스토어 배포 프로세스로 새 네이티브 앱 버전을 릴리스하세요.

이전 네이티브 설치본은 사용자가 새 네이티브 버전을 설치할 때까지 설정된 엔드포인트 URL을 계속 사용합니다. 업데이터의 기본 호스트명은 plugin.capgo.app이며, Capgo이 관리합니다. 직접 관리하는 다른 커스텀 호스트명에서 마이그레이션하는 경우, 해당 사용자가 마이그레이션을 마칠 때까지 DNS 레코드와 서비스를 활성 상태로 유지하세요. 채널, 번들 업로드, 롤백은 평소처럼 Capgo Console 및 CLI 워크플로를 계속 사용합니다.

도메인을 제거하려면 도메인 제거 → 제거 확인 을 조직 설정에서 사용하세요. 먼저 대체 엔드포인트를 사용하여 네이티브 앱 버전을 릴리스하고 사용자가 마이그레이션할 수 있도록 하세요: 이전 설치본은 제거된 호스트명을 통한 접근 권한을 잃게 됩니다. 조직을 삭제하기 전에 도메인을 제거하세요.

  • DNS가 해석되지 않습니다: 지원팀에서 제공한 값과 레코드 이름 및 타겟을 대조하고, DNS 제공업체에서 전파 상태를 확인하세요.
  • HTTPS가 실패합니다: 네이티브 빌드를 릴리스하기 전에 지원팀에 호스트명 활성화 및 인증서 프로비저닝을 확인해 달라고 요청하세요.
  • 요청이 여전히 다음을 사용합니다 plugin.capgo.app: 세 개의 URL을 모두 확인하고, 다음을 실행하세요 npx cap sync, 다시 빌드하고 새 네이티브 버전을 설치하세요.
  • Bundle 다운로드가 다른 호스트명을 사용합니다: 업데이트 응답이 다운로드 URL을 제공합니다. 커스텀 bundle 전달에 대해 지원팀에 문의하거나, 다음을 참고하세요 커스텀 스토리지 bundle 저장소를 직접 관리하려면.
  • 유효한 HTTPS에도 업데이트가 실패하는 경우: 앱 ID, 채널, native version, 요청 타임스탬프, native logs를 Capgo 지원팀에 공유해 주세요..

자세한 내용은 Updater 설정 전체 구성 참조와 데이터 위치 지역별 엔드포인트 요구 사항을 확인하세요.