DevOps 실습 - Firebase PaaS 기반

[1] 로컬 개발 및 Firebase 프로젝트 초기화
 ├─ 목표: Python 함수 개발, Firebase CLI를 이용한 로컬 프로젝트 설정
 ├─ Firebase 프로젝트 생성 (Google Cloud 콘솔)
 ├─ Firebase CLI 설치 및 로그인 (firebase login)
 ├─ Firebase 프로젝트 초기화 (firebase init functions, firebase init hosting)
 ├─ Python 함수 (main.py) 작성: HTTP 요청 처리
 ├─ requirements.txt 작성 (파이썬 의존성)
 ├─ Firebase Functions (파이어베이스 펑션즈) 설정: runtime (런타임)을 Python으로 지정
 ├─ 로컬에서 함수 및 호스팅 테스트 (firebase emulators:start)

[2] GitHub 저장소에 코드 Push (Git을 통한 버전 관리)
 ├─ 목표: 함수 코드 및 Firebase 설정 파일을 GitHub에 공유
 ├─ 코드 (functions/, public/, firebase.json, .firebaserc 등) 업로드
 ├─ .env 및 venv 폴더 .gitignore에 추가

[3] GitHub Actions를 통한 CI/CD 파이프라인 구축
 ├─ 목표: 코드 Push 시 Cloud Functions 및 Hosting 자동 배포
 ├─ Firebase 서비스 계정 생성 및 Key (키) 발급 (GitHub Secrets에 저장)
 ├─ .github/workflows/firebase-deploy.yml 파일 작성
 ├─ GitHub Actions 워크플로의 트리거, 잡(Job), 단계(Step) 이해
 ├─ Firebase Deploy 액션 사용법 익히기

[4] Firebase 애플리케이션 공개 및 확인
 ├─ 목표: 배포된 API 엔드포인트 및 웹 페이지 확인
 ├─ Cloud Functions (클라우드 펑션즈) 콘솔에서 배포된 함수 URL 확인
 ├─ Firebase Hosting (파이어베이스 호스팅) URL을 통해 웹 페이지 접근 및 함수 호출 확인

my_firebase_project/
 ├── .github/
 │    └── workflows/
 │         └── firebase-deploy.yml       # GitHub Actions 워크플로
 ├── functions/                          # Cloud Functions 소스 코드 디렉토리
 │    ├── __init__.py
 │    ├── main.py
 │    ├── requirements.txt
 │    └── .python-version               # Python 버전 명시 (선택 사항)
 ├── public/                             # Firebase Hosting 정적 파일 디렉토리
 │    └── index.html                    # 웹 페이지 예시
 ├── .firebaserc                         # Firebase 프로젝트 설정
 ├── firebase.json                       # Firebase 호스팅 및 함수 설정
 ├── .env                                # 로컬 환경변수 (Git 커밋 제외)
 ├── .gitignore                          # Git 추적에서 제외
 ├── README.md                           # 프로젝트 설명

name: Deploy to Firebase # 워크플로 이름

on:
  push:
    branches:
      - main # main 브랜치에 푸시될 때 워크플로 실행
  pull_request:
    branches:
      - main # main 브랜치로 풀 리퀘스트 생성/업데이트 시 워크플로 실행

jobs:
  build_and_deploy: # 작업(Job) 이름
    runs-on: ubuntu-latest # 작업을 실행할 가상 머신 환경

    steps:
    - name: Checkout code # GitHub 저장소의 코드를 워크플로 환경으로 가져옵니다.
      uses: actions/checkout@v4

    - name: Set up Node.js # Firebase CLI 설치를 위해 Node.js를 설정합니다.
      uses: actions/setup-node@v4
      with:
        node-version: '20' # Firebase CLI 및 Cloud Functions 런타임에 맞는 Node.js 버전

    - name: Install Firebase CLI # Firebase CLI를 설치합니다.
      run: npm install -g firebase-tools

    - name: Set up Python # Cloud Functions Python 런타임을 설정합니다.
      uses: actions/setup-python@v5
      with:
          python-version: '3.11' # functions/.python-version 또는 firebase.json의 runtime과 일치시킵니다.
          cache: 'pip'

    - name: Install Python dependencies # functions 디렉토리의 Python 의존성을 설치합니다.
      working-directory: ./functions # functions 디렉토리 안에서 실행
      run: pip install -r requirements.txt

    - name: Deploy to Firebase # Firebase에 배포합니다.
      # 이 단계에서 Cloud Functions와 Hosting이 모두 배포됩니다.
      run: firebase deploy --token ${{ secrets.FIREBASE_SERVICE_ACCOUNT_KEY }} --project ${{ secrets.FIREBASE_PROJECT_ID }}
      env:
        # Cloud Functions 환경 변수 (예시: API_KEY). Secrets Manager 사용 권장.
        # 이 예시에서는 GitHub Secrets에 저장된 API_KEY를 직접 Cloud Function으로 전달합니다.
        # 실제 환경에서는 Firebase Secret Manager를 사용하는 것이 더 안전합니다.
        # firebase functions:secrets:set API_KEY="your_real_api_key" --project YOUR_PROJECT_ID
        API_KEY: ${{ secrets.YOUR_API_KEY_SECRET }} # GitHub Secrets에 YOUR_API_KEY_SECRET으로 API KEY를 추가했다면 사용.
                                                    # 만약 Cloud Functions 내에서 Firebase Secret Manager를 사용할 예정이라면 이 줄은 제거.
      # 프로젝트 ID도 Secret으로 관리하는 것이 좋습니다.
    - name: Save Firebase Project ID (Optional)
      run: |
        echo "FIREBASE_PROJECT_ID=${{ secrets.FIREBASE_PROJECT_ID }}" >> $GITHUB_ENV