App Hosting 빌드 프로세스

Firebase App Hosting은 Cloud Build을 활용하여 애플리케이션 소스 코드를 Cloud Run에 배포하기에 적합한 컨테이너화된 형식으로 변환합니다.

빌드 프로세스는 다음 주요 단계를 통해 작동합니다.

  1. ubuntu: 워크스페이스 초기화

  2. preparer: 애플리케이션 소스 코드와 구성을 수집합니다.

  3. pre-buildpack: 빌드팩 환경을 준비합니다.

  4. build: 종속 항목을 설치하고 애플리케이션을 빌드합니다.

  5. 게시자: 프로덕션 Cloud Run 컨테이너를 완료합니다.

이 5단계는 Google Cloud 콘솔의 Cloud Build에 표시된 빌드 단계에 직접 해당합니다.

Cloud Build 단계의 Google Cloud 콘솔 뷰 화면 캡처

Workspace 초기화

이 단계는 Ubuntu 빌드 단계에 해당합니다. 빌드 작업공간을 초기화하여 후속 빌드 단계에서 사용하는 디렉터리에 올바른 파일 권한이 설정되도록 합니다.

준비자

이 단계는 빌드 전 로직을 처리합니다. 사용자 정의 환경 변수를 읽고, 정리하고, 씁니다. 또한 apphosting.yaml 파일에 지정된 모든 비밀번호를 역참조하고 고정합니다.

사전 빌드팩

이 단계에서는 Cloud Native Buildpack 수명 주기를 위한 환경을 준비합니다. 여기에는 이전 단계에서 준비한 구성과 환경 변수를 CNB 도구에서 예상하는 형식으로 변환하는 shim을 실행하는 작업이 포함됩니다.

빌드

실행 가능한 컨테이너 이미지와 빌드 구성을 정의하는 bundle.yaml 파일을 생성하는 빌드 프로세스의 핵심입니다. Cloud Native Buildpack과 lifecycle creator 바이너리를 사용하여 애플리케이션을 효율적으로 패키징합니다. bundle.yaml 파일에 관한 자세한 내용은 github에서 확인할 수 있습니다.

빌드팩은 애플리케이션 소스 코드를 프로덕션 지원 컨테이너 이미지로 변환하는 역할을 합니다. Firebase App Hosting는 여러 빌드팩을 연결하여 빌드 프로세스를 완료합니다.

  1. 런타임 빌드팩: 기본 Node.js 애플리케이션을 실행하는 데 필요한 모든 구성요소가 포함되고 종속 항목이 설치되도록 합니다.
  2. Monorepo 빌드팩: 다양한 monorepo 시나리오를 처리하도록 후속 빌드팩을 구성합니다.

  3. 프레임워크 빌드팩: 올바른 프레임워크 어댑터 (예: Angular 또는 Next.js)를 설치하고 후속 빌드팩을 준비합니다.

    프레임워크 어댑터는 프로덕션 빌드 명령어를 실행하고 관련 프레임워크별 구성 값을 App Hosting에서 읽을 수 있는 표준 형식에 매핑하는 역할을 합니다.

  4. 패키지 관리자 빌드팩: npm, yarn 또는 pnpm을 사용하여 종속 항목 설치를 실행하고 앱을 빌드합니다.

  5. 출력 번들 빌드팩: 실행 명령어를 정의하고 실행을 위해 출력 번들을 준비합니다.

게시자

이 최종 단계에서는 애플리케이션 소스 코드에서 추출한 모든 정보와 빌드 컨테이너 이미지를 패키징하여 App Hosting 백엔드로 전송합니다. 그러면 App Hosting 백엔드에서 이 정보를 사용하여 적절한 구성으로 Cloud Run을 설정합니다.

자세히 알아보기

전체 App Hosting 빌드 프로세스는 오픈소스입니다.