Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

팁 & 트릭

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 문서에서는 Cloud Functions 설계, 구현, 테스트 및 배포에 대한 권장사항을 설명합니다.

단정

이 섹션에서는 Cloud Functions 설계 및 구현에 대한 일반적인 권장사항을 설명합니다.

멱등 함수 작성

함수는 여러 번 호출되더라도 동일한 결과를 생성해야 합니다. 이렇게 하면 이전 호출이 코드 도중에 실패한 경우 호출을 다시 시도할 수 있습니다. 자세한 내용은 이벤트 기반 함수 재시도 를 참조하세요.

백그라운드 활동을 시작하지 마십시오

백그라운드 활동은 함수가 종료된 후에 발생하는 모든 것입니다. 함수 호출은 함수가 반환되거나 Node.js 이벤트 기반 함수에서 callback 인수를 호출하는 것과 같이 완료 신호를 보내면 완료됩니다. 단계적 종료 후에 실행되는 코드는 CPU에 액세스할 수 없으며 진행되지 않습니다.

또한 동일한 환경에서 후속 호출이 실행되면 백그라운드 활동이 재개되어 새 호출을 방해합니다. 이로 인해 예기치 않은 동작과 진단하기 어려운 오류가 발생할 수 있습니다. 기능이 종료된 후 네트워크에 액세스하면 일반적으로 연결이 재설정됩니다( ECONNRESET 오류 코드).

호출이 완료되었다는 줄 뒤에 기록된 모든 항목을 찾아 개별 호출의 로그에서 백그라운드 활동을 감지할 수 있습니다. 특히 콜백 또는 타이머와 같은 비동기 작업이 있는 경우 백그라운드 작업이 코드에 더 깊이 묻힐 수 있습니다. 함수를 종료하기 전에 코드를 검토하여 모든 비동기 작업이 완료되었는지 확인하십시오.

항상 임시 파일 삭제

임시 디렉토리의 로컬 디스크 저장소는 메모리 내 파일 시스템입니다. 작성하는 파일은 함수에 사용할 수 있는 메모리를 소비하며 때로는 호출 간에 지속됩니다. 이러한 파일을 명시적으로 삭제하지 않으면 결국 메모리 부족 오류가 발생하고 후속 콜드 스타트가 발생할 수 있습니다.

GCP Console 의 함수 목록 에서 선택하고 메모리 사용량 플롯을 선택하면 개별 함수에서 사용하는 메모리를 확인할 수 있습니다.

임시 디렉토리 외부에 쓰려고 시도하지 말고 플랫폼/OS에 독립적인 방법을 사용하여 파일 경로를 구성하십시오.

파이프라이닝을 사용하여 더 큰 파일을 처리할 때 메모리 요구 사항을 줄일 수 있습니다. 예를 들어 읽기 스트림을 만들고 스트림 기반 프로세스를 통해 전달하고 Cloud Storage에 직접 출력 스트림을 작성하여 Cloud Storage에서 파일을 처리할 수 있습니다.

도구

이 섹션에서는 도구를 사용하여 Cloud Functions를 구현, 테스트 및 상호작용하는 방법에 대한 가이드라인을 제공합니다.

지역 개발

함수 배포에는 약간의 시간이 걸리므로 로컬에서 함수 코드를 테스트하는 것이 더 빠른 경우가 많습니다.

Firebase 개발자는 Firebase CLI Cloud Functions Emulator 를 사용할 수 있습니다.

Sendgrid를 사용하여 이메일 보내기

Cloud Functions는 포트 25에서 아웃바운드 연결을 허용하지 않으므로 SMTP 서버에 대한 비보안 연결을 만들 수 없습니다. 이메일을 보내는 권장 방법은 SendGrid 를 사용하는 것입니다. Google Compute Engine에 대한 인스턴스에서 이메일 보내기 튜토리얼에서 이메일을 보내기 위한 다른 옵션을 찾을 수 있습니다.

성능

이 섹션에서는 성능 최적화를 위한 모범 사례에 대해 설명합니다.

종속성을 현명하게 사용

함수는 상태 비저장이므로 실행 환경은 종종 처음부터 초기화됩니다( 콜드 스타트 ​​로 알려진 동안). 콜드 스타트가 발생하면 함수의 전역 컨텍스트가 평가됩니다.

함수가 모듈을 가져오는 경우 해당 모듈의 로드 시간이 콜드 스타트 ​​동안 호출 대기 시간에 추가될 수 있습니다. 종속성을 올바르게 로드하고 함수에서 사용하지 않는 종속성을 로드하지 않음으로써 이 지연 시간과 함수 배포에 필요한 시간을 줄일 수 있습니다.

전역 변수를 사용하여 향후 호출에서 객체 재사용

향후 호출을 위해 Cloud Function의 상태가 보존된다는 보장은 없습니다. 그러나 Cloud Functions는 종종 이전 호출의 실행 환경을 재활용합니다. 전역 범위에서 변수를 선언하면 해당 값을 다시 계산하지 않고도 후속 호출에서 재사용할 수 있습니다.

이렇게 하면 각 함수 호출에서 다시 만드는 데 비용이 많이 들 수 있는 개체를 캐시할 수 있습니다. 이러한 개체를 함수 본문에서 전역 범위로 이동하면 성능이 크게 향상될 수 있습니다. 다음 예제에서는 무거운 개체를 함수 인스턴스당 한 번만 만들고 지정된 인스턴스에 도달하는 모든 함수 호출에서 이를 공유합니다.

console.log('Global scope');
const perInstance = heavyComputation();
const functions = require('firebase-functions');

exports.function = functions.https.onRequest((req, res) => {
    console.log('Function invocation');
    const perFunction = lightweightComputation();

    res.send(`Per instance: ${perInstance}, per function: ${perFunction}`);
});

전역 범위에서 네트워크 연결, 라이브러리 참조 및 API 클라이언트 개체를 캐시하는 것이 특히 중요합니다. 예제는 네트워킹 최적화 를 참조하십시오.

전역 변수의 지연 초기화 수행

전역 범위에서 변수를 초기화하면 초기화 코드가 항상 콜드 스타트 ​​호출을 통해 실행되어 함수의 대기 시간이 늘어납니다. 경우에 따라 try / catch 블록에서 적절하게 처리되지 않으면 호출되는 서비스에 간헐적인 시간 초과가 발생합니다. 일부 개체가 모든 코드 경로에서 사용되지 않는 경우 요청 시 느리게 초기화하는 것이 좋습니다.

const functions = require('firebase-functions');
let myCostlyVariable;

exports.function = functions.https.onRequest((req, res) => {
    doUsualWork();
    if(unlikelyCondition()){
        myCostlyVariable = myCostlyVariable || buildCostlyVariable();
    }
    res.status(200).send('OK');
});

이는 단일 파일에 여러 함수를 정의하고 다른 함수가 다른 변수를 사용하는 경우 특히 중요합니다. 지연 초기화를 사용하지 않으면 초기화되었지만 사용되지 않는 변수에 리소스를 낭비할 수 있습니다.

최소 인스턴스 수를 설정하여 콜드 스타트 ​​감소

기본적으로 Cloud Functions는 수신 요청 수에 따라 인스턴스 수를 조정합니다. Cloud Functions가 요청을 처리하기 위해 준비해야 하는 최소 인스턴스 수를 설정하여 이 기본 동작을 변경할 수 있습니다. 최소 인스턴스 수를 설정하면 애플리케이션의 콜드 스타트가 줄어듭니다. 애플리케이션이 지연 시간에 민감한 경우 최소 인스턴스 수를 설정하는 것이 좋습니다.

이러한 런타임 옵션에 대한 자세한 내용은 조정 동작 제어 를 참조하십시오.

추가 리소스

'Google Cloud Performance Atlas' 동영상 Cloud Functions Cold Boot Time 에서 성능 최적화에 대해 자세히 알아보세요.