Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

사이트의 라이브 및 미리 보기 채널, 릴리스 및 버전 관리

Firebase 호스팅은 Firebase 콘솔과 Firebase CLI를 통해 호스팅 사이트의 채널, 릴리스 및 버전을 관리하는 도구를 제공합니다.

호스팅 인프라 개요

호스팅 인프라를 이해하면 이 페이지에 설명된 관리 옵션을 이해하는 데 도움이 됩니다.

모든 중포 기지 프로젝트는 모든 프로젝트의 자원 (데이터베이스, 인증, 기능 등)에 액세스 할 수있는 기본 호스팅 사이트가 있습니다. 사이트는 각 채널은 특정 콘텐츠와 호스팅 구성을 제공하는 URL과 연관된 하나 개 이상의 채널을 포함한다.

Firebase 호스팅 계층 구조의 이미지

모든 호스팅 사이트의 콘텐츠를 제공하는 "라이브"채널 (1) 사이트의 중포 기지 프로비저닝 하위 도메인에서 호스팅 설정 (이 SITE_ID .web.appSITE_ID .firebaseapp.com ) 및 (2)에 연결된 사용자 지정 도메인을 . (당신은 또한 선택적으로 임시 공유 할 수있는 '미리보기 URL "에서 자신의 콘텐츠와 구성을 제공"미리보기 "채널을 만들 수 있습니다 SITE_ID -- CHANNEL_ID - RANDOM_HASH .web.app ).

각 채널에서 제공하는 컨텐츠와 구성은 고유 식별자를 갖는 객체 버전으로 패키징된다. 귀하의 사이트에 배포 할 때, 중포 기지가 출시 객체를 생성하는 특정 버전을 가리. 릴리스에는 배포한 사람 및 배포한 시기와 같은 배포에 대한 메타데이터가 포함되어 있습니다.

당신의 중포 기지 프로젝트에서 호스팅 대시 보드 , 당신은 릴리스 기록 테이블에 라이브 채널의 릴리스의 전체 역사를 볼 수 있습니다. 당신이있는 경우 여러 호스팅 사이트 , 출시 기록을보고 원하는 사이트에 대한보기를 클릭합니다. 미리보기 채널이 있는 경우 호스팅 대시보드에도 표시됩니다.

채널 설정 관리

사이트의 각 채널에 대해 설정을 제어할 수 있습니다. 채널 만료와 같은 일부 설정은 미리보기 채널에만 적용됩니다.

유지할 릴리스 수 제한

채널에 배포하고 릴리스를 만들 때마다 호스팅은 프로젝트의 호스팅 스토리지에 이전 릴리스와 연결된 버전을 유지합니다. 당신은 당신의 프로젝트를 모두 라이브 및 미리보기 채널에서 각 채널에 대해 계속 자료의 수를 설정할 수 있습니다.

  • 호스팅이 이전 릴리스를 유지하는 이유는 무엇입니까?
    라이브 채널의 경우, 이전 버전을 유지하는 할 수 있습니다 롤백 필요한 경우, 사이트의 이전 버전으로. 미리보기 채널의 경우 아직 롤백할 수 없습니다.

  • 유지할 릴리스 수를 제한하는 이유는 무엇입니까?
    이 기능을 사용하면의 사용 수준을 제어 할 수 있습니다 프로젝트의 호스팅 스토리지를 이전 버전의 내용이 저장소에 보관 될 때. 당신은에서 호스팅 스토리지 모니터링 할 수 있습니다 저장소 탭 콘솔에 있습니다.

  • 유지하도록 릴리스를 제한하면 어떻게 됩니까?
    당신이 계속 릴리스에 대한 제한을 설정하면 사용자의 설정 한도를 넘는 자료의 내용은 가장 오래된 출시를 시작으로 삭제 예정이다.

채널의 출시 저장 한도를 설정하는 방법은 다음과 같습니다.

  1. 에서 중포 기지 콘솔 액세스 릴리스 저장 설정 대화 상자 :

    • 라이브 채널의 경우
      사이트의 릴리스 내역 테이블에서 클릭 , 다음 릴리스 저장 설정을 선택합니다.

    • 모든 미리보기 채널의 경우
      미리보기 채널에 대한 행에서 클릭 다음 채널 설정을 선택합니다.

  2. 당신이 보관하고 싶은 자료의 번호를 입력 한 다음 저장을 클릭합니다.

미리보기 채널 만료 설정

기본적으로 미리보기 채널은 생성일로부터 7일 후에 만료되지만 사이트의 라이브 채널은 만료되지 않습니다.

미리 보기 채널이 만료되면 해당 릴리스 및 관련 버전과 함께 채널이 24시간 이내에 삭제되도록 예약됩니다. 연결된 미리보기 URL도 비활성화됩니다. 버전이 (같은 사이트 내에서 한 채널에서 다른 채널 버전을 복제 할 경우이, 예를 들어, 일) 다른 자료와 관련된 경우이 버전 삭제에 대한 예외입니다.

호스팅은 채널 만료를 제어하는 ​​두 가지 다른 방법을 지원합니다.

  • Firebase 콘솔
    미리보기 채널에 대한 행에서 클릭 다음 채널 설정을 선택합니다. 만료 날짜와 시간을 입력합니다.

  • Firebase CLI
    당신이 당신의 미리보기 채널에 배포 할 때 통과 --expires DURATION 예를 들어 플래그를 :

    firebase hosting:channel:deploy new-awesome-feature --expires 7d

    만료 날짜는 배포 날짜로부터 최대 30일입니다. 사용 h 시간, d 일 및 w (예를 들어, 주 12h , 7d , 2w 각각).

한 채널에서 다른 채널로 버전 복제

한 채널에서 다른 채널로 배포된 버전을 복제할 수 있습니다. 라이브 또는 미리보기 채널, 호스팅 사이트 또는 Firebase 프로젝트 전체에서 복제할 수 있습니다.

클론 명령은 복제 된 호스팅 내용과 설정이 자동으로 "대상"채널의 관련 URL에서 제공되도록 "대상"채널로 배포합니다.

이 기능은 버전 추적에 유용 또는 당신은 당신이 다른 채널에서 볼 및 / 또는 테스트 한 정확한 내용을 배포하는 확신을합니다. 여기 몇 가지 예가 있어요.

  • "QA" 미리보기 채널에서 사이트의 라이브 채널로 복제(라이브 시작!)

  • 사이트의 라이브 채널에서 "디버그" 미리보기 채널로 복제(예: 롤백 전)

  • "스테이징" Firebase 프로젝트의 채널에서 "프로덕트" Firebase 프로젝트의 미리보기 채널로 복제

버전을 복제하려면 아무 디렉터리에서나 다음 명령을 실행합니다.

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

각 자리 표시자를 다음으로 바꿉니다.

  • SOURCE_SITE_IDTARGET_SITE_ID : 이러한 채널을 포함하는 호스팅 사이트의 ID가 있습니다.

    • 기본 호스팅 사이트의 경우 Firebase 프로젝트 ID를 사용합니다.
    • 동일한 Firebase 프로젝트 또는 다른 Firebase 프로젝트에 있는 호스팅 사이트를 지정할 수 있습니다.
  • SOURCE_CHANNEL_IDTARGET_CHANNEL_ID : 다음은 채널의의 식별자입니다.

    • 라이브 채널의 경우, 사용 live 채널 ID로.
    • 지정된 "대상" 채널이 아직 존재하지 않는 경우 이 명령은 배포하기 전에 채널을 만듭니다.

사이트의 이전 버전으로 롤백

사이트 라이브 채널의 이전 버전을 제공하도록 롤백할 수 있습니다. 이 작업은 현재 릴리스에 문제가 있고 사이트의 알려진 작동 버전을 제공하기 위해 롤백하려는 경우에 유용합니다. 또는 귀하의 사이트에서 휴일이나 특별 이벤트를 위한 임시 콘텐츠를 제공했지만 지금은 "일반" 콘텐츠를 제공하기 위해 롤백하려고 할 수 있습니다.

롤백하면 이전 릴리스와 동일한 버전의 콘텐츠를 제공하는 새 릴리스를 만들 수 있습니다. 당신의 릴리스 기록 테이블에서 두 버전은 동일한 버전 식별자를 나열합니다.

롤백하는 방법은 다음과 같습니다.

  1. 에서 중포 기지 콘솔 사이트의 릴리스 내역 테이블에서, 이전 릴리스의 항목 위에 마우스를 올려 당신은에 롤 백업 할 것이다.

  2. 클릭 다음 롤 백을 선택합니다.

수동으로 릴리스 삭제

수동으로 확보하기 위해 라이브 채널에서 자료를 삭제해야 할 수도 있습니다 스토리지 호스팅 프로젝트에. 라이브 사이트에서 현재 제공 중인 릴리스가 아닌 이전 릴리스만 삭제할 수 있습니다.

릴리스를 삭제하면 실제로는 24시간 이내에 삭제되도록 예약된 콘텐츠가 삭제됩니다. 릴리스 개체 자체가 유지되므로 해당 메타데이터(배포된 사람 및 배포 시기)를 계속 볼 수 있습니다.

릴리스를 삭제하는 방법은 다음과 같습니다.

  1. 에서 중포 기지 콘솔 사이트에서 삭제할 것을 이전 릴리스의 항목 위에 마우스를위한 릴리스 내역 테이블.

  2. 클릭 한 다음 삭제를 선택합니다.

미리보기 채널을 수동으로 삭제

미리보기 채널은 삭제할 수 있지만 사이트의 라이브 채널은 삭제할 수 없습니다.

미리 보기 채널을 삭제하면 해당 릴리스 및 관련 버전과 함께 채널이 24시간 이내에 삭제되도록 예약됩니다. 연결된 미리보기 URL도 비활성화됩니다. 버전이 (같은 사이트 내에서 한 채널에서 다른 채널 버전을 복제 할 경우이, 예를 들어, 일) 다른 자료와 관련된 경우 버전 삭제에 대한 예외입니다.

호스팅은 미리보기 채널을 삭제하는 두 가지 방법을 지원합니다.

  • Firebase 콘솔
    미리보기 채널에 대한 행에서 클릭 다음 삭제 채널을 선택합니다. 삭제를 확인합니다.

  • Firebase CLI
    임의의 디렉토리에서 다음 명령을 실행하십시오.

    firebase hosting:channel:delete CHANNEL_ID

채널 미리보기 및 복제를 위한 CLI 명령

미리보기 채널에 대한 명령

당신이있는 경우 미리 채널에 대한 모든 명령은 배포 목표를 지원하는 여러 호스팅 사이트를 .

명령 설명
firebase hosting:channel:create CHANNEL_ID

지정된 사용하여 기본 호스팅 사이트의 새 미리보기 채널 작성 CHANNEL_ID

이 명령은 채널에 배포되지 않습니다.

firebase hosting:channel:delete CHANNEL_ID

지정된 미리보기 채널을 삭제합니다.

사이트의 라이브 채널은 삭제할 수 없습니다.

firebase hosting:channel:deploy CHANNEL_ID

호스팅 콘텐츠 및 구성을 지정된 미리보기 채널에 배포합니다.

미리보기 채널이 존재하지 않는 경우,이 명령은 채널에 배포하기 전에 기본 호스팅 사이트의 채널을 만듭니다.

firebase hosting:channel:list 목록 기본 호스팅 사이트 (이하 "라이브"채널 포함) 모든 채널
firebase hosting:channel:open CHANNEL_ID 지정된 채널의 URL에 대한 브라우저를 열거나 브라우저에서 열 수 없는 경우 URL을 반환합니다.

버전 복제 명령

명령 설명
firebase hosting:clone \
SOURCE_SITE_ID : SOURCE_CHANNEL_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

지정된 "소스" 채널에서 가장 최근에 배포된 버전을 지정된 "대상" 채널로 복제합니다.

이 명령은 지정된 "대상" 채널에도 배포합니다. "대상" 채널이 아직 존재하지 않는 경우 이 명령은 채널에 배포하기 전에 "대상" 호스팅 사이트에 새 미리 보기 채널을 만듭니다.

firebase hosting:clone \
SOURCE_SITE_ID :@ VERSION_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

지정된 "대상" 채널에 지정된 버전을 복제합니다.

이 명령은 지정된 "대상" 채널에도 배포합니다. "대상" 채널이 아직 존재하지 않는 경우 이 명령은 채널에 배포하기 전에 "대상" 호스팅 사이트에 새 미리 보기 채널을 만듭니다.

당신은 찾을 수 VERSION_ID호스팅 대시 보드 중포 기지 콘솔.