GCP 테스트 전략 완벽 가이드

Google Cloud Platform에서의 효과적인 테스트 전략을 단계별로 학습합니다. 단위 테스트부터 통합 테스트, E2E 테스트까지 실전 예제로 배웁니다.

---

---

들어가며

이 글에서는 GCP 테스트 전략 완벽 가이드에 대해 상세히 알아보겠습니다. 총 10가지 주요 개념을 다루며, 각각의 개념에 대한 설명과 실제 코드 예제를 함께 제공합니다.

목차

1. Cloud_Functions_단위_테스트
2. Firestore_모킹_테스트
3. Pub/Sub_메시지_테스트
4. Cloud_Storage_통합_테스트
5. API_엔드포인트_E2E_테스트
6. Cloud_Run_헬스체크_테스트
7. 환경변수_모킹_테스트
8. BigQuery_쿼리_테스트
9. Secret_Manager_테스트
10. Cloud_Tasks_큐_테스트

---

1. Cloud Functions 단위 테스트

개요

GCP Cloud Functions의 기본 단위 테스트 작성 방법입니다. pytest를 사용하여 함수의 동작을 검증합니다.

코드 예제

import pytest
from unittest.mock import Mock

def test_hello_function():
    req = Mock(args={'name': 'World'})
    from main import hello
    result = hello(req)
    assert 'Hello World' in result

설명

Mock 객체로 요청을 시뮬레이션하고 함수의 반환값을 검증합니다. pytest의 assert 문으로 간단하게 테스트할 수 있습니다.

---

2. Firestore 모킹 테스트

개요

Firestore 데이터베이스 작업을 모킹하여 테스트합니다. 실제 DB 연결 없이 빠른 테스트가 가능합니다.

코드 예제

from unittest.mock import patch, MagicMock

@patch('google.cloud.firestore.Client')
def test_save_user(mock_firestore):
    mock_db = MagicMock()
    mock_firestore.return_value = mock_db

    save_user({'name': 'John', 'age': 30})
    mock_db.collection.assert_called_once()

설명

patch 데코레이터로 Firestore 클라이언트를 모킹하고, 함수 호출을 추적하여 올바르게 작동하는지 확인합니다.

---

3. Pub/Sub 메시지 테스트

개요

Cloud Pub/Sub 메시지 처리 함수를 테스트합니다. base64 인코딩된 데이터를 올바르게 처리하는지 검증합니다.

코드 예제

import base64
import json

def test_pubsub_handler():
    data = json.dumps({'user_id': 123})
    event = {
        'data': base64.b64encode(data.encode()).decode()
    }
    result = process_message(event, None)
    assert result['status'] == 'success'

설명

실제 Pub/Sub 이벤트 형식을 재현하여 메시지 핸들러가 데이터를 정확히 디코딩하고 처리하는지 테스트합니다.

---

4. Cloud Storage 통합 테스트

개요

Cloud Storage와의 통합을 테스트합니다. 테스트용 버킷을 사용하여 실제 업로드/다운로드를 검증합니다.

코드 예제

from google.cloud import storage

def test_upload_file():
    client = storage.Client()
    bucket = client.bucket('test-bucket')
    blob = bucket.blob('test.txt')
    blob.upload_from_string('test data')

    assert blob.exists()
    blob.delete()

설명

테스트 환경에서 실제 Storage 작업을 수행하고, 테스트 후 리소스를 정리합니다. 실제 GCP 환경과 동일하게 동작합니다.

---

5. API 엔드포인트 E2E 테스트

개요

Flask/FastAPI로 작성된 API의 전체 플로우를 테스트합니다. 요청부터 응답까지 전 과정을 검증합니다.

코드 예제

from flask import Flask
import pytest

@pytest.fixture
def client():
    app = Flask(__name__)
    return app.test_client()

def test_api_endpoint(client):
    response = client.get('/api/users/1')
    assert response.status_code == 200
    assert 'name' in response.json

설명

Flask의 test_client를 사용하여 실제 HTTP 요청을 시뮬레이션하고, 응답 코드와 데이터 구조를 검증합니다.

---

6. Cloud Run 헬스체크 테스트

개요

Cloud Run 서비스의 헬스체크 엔드포인트를 테스트합니다. 서비스가 정상적으로 응답하는지 확인합니다.

코드 예제

import requests

def test_health_check():
    url = "https://myapp-abc123.run.app/health"
    response = requests.get(url, timeout=5)

    assert response.status_code == 200
    assert response.json()['status'] == 'healthy'

설명

실제 배포된 서비스에 HTTP 요청을 보내 헬스체크 엔드포인트가 올바르게 작동하는지 확인합니다.

---

7. 환경변수 모킹 테스트

개요

GCP 환경변수에 의존하는 코드를 테스트합니다. 로컬에서도 안전하게 테스트할 수 있습니다.

코드 예제

import os
from unittest.mock import patch

@patch.dict(os.environ, {
    'PROJECT_ID': 'test-project',
    'BUCKET_NAME': 'test-bucket'
})
def test_with_env_vars():
    project = os.getenv('PROJECT_ID')
    assert project == 'test-project'

설명

patch.dict로 환경변수를 임시로 설정하여 실제 GCP 프로젝트 설정 없이 코드를 테스트할 수 있습니다.

---

8. BigQuery 쿼리 테스트

개요

BigQuery 쿼리 실행을 모킹하여 테스트합니다. 비용 발생 없이 쿼리 로직을 검증합니다.

코드 예제

from unittest.mock import patch, MagicMock

@patch('google.cloud.bigquery.Client')
def test_run_query(mock_bq):
    mock_client = MagicMock()
    mock_bq.return_value = mock_client
    mock_client.query().result.return_value = [{'count': 10}]

    result = get_user_count()
    assert result == 10

설명

BigQuery 클라이언트와 쿼리 결과를 모킹하여 실제 쿼리 실행 없이 데이터 처리 로직을 테스트합니다.

---

9. Secret Manager 테스트

개요

Secret Manager에서 비밀 값을 가져오는 코드를 테스트합니다. 실제 시크릿 없이 모킹으로 처리합니다.

코드 예제

from unittest.mock import patch

@patch('google.cloud.secretmanager.SecretManagerServiceClient')
def test_get_secret(mock_client):
    mock_client().access_secret_version.return_value.payload.data = b'my-secret'

    secret = get_database_password()
    assert secret == 'my-secret'

설명

Secret Manager 클라이언트를 모킹하여 실제 시크릿에 접근하지 않고도 시크릿 처리 로직을 안전하게 테스트합니다.

---

10. Cloud Tasks 큐 테스트

개요

Cloud Tasks 큐에 태스크를 추가하는 기능을 테스트합니다. 태스크 생성과 파라미터 전달을 검증합니다.

코드 예제

from unittest.mock import patch, MagicMock

@patch('google.cloud.tasks_v2.CloudTasksClient')
def test_create_task(mock_client):
    mock_client().create_task.return_value = MagicMock(name='task-1')

    task_name = create_background_task({'user_id': 123})
    assert 'task-1' in task_name

설명

Cloud Tasks 클라이언트를 모킹하여 백그라운드 작업 생성 로직이 올바른 파라미터로 호출되는지 확인합니다.

---

마치며

이번 글에서는 GCP 테스트 전략 완벽 가이드에 대해 알아보았습니다. 총 10가지 개념을 다루었으며, 각각의 사용법과 예제를 살펴보았습니다.

관련 태그

#Python #GCP #Testing #UnitTest #CloudFunctions