Cloud Storage 트리거

Cloud Storage에 있는 파일과 폴더의 업로드, 업데이트 또는 삭제에 대한 응답으로 함수를 트리거할 수 있습니다.

이 페이지의 예시는 Cloud Storage에 이미지 파일이 업로드되면 트리거되는 샘플 함수를 기반으로 한 것입니다. 이 샘플 함수는 이벤트 속성 액세스 방법, Cloud Functions 인스턴스로 파일을 다운로드하는 방법을 비롯하여 Cloud Storage 이벤트 처리와 관련된 그 밖의 기본사항을 보여줍니다.

Cloud Storage 변경사항에 대한 함수 트리거

firebase-functions/v2/storage 하위 패키지를 사용하여 Cloud Storage 이벤트를 처리하는 함수를 만듭니다. 특정 Cloud Storage 버킷으로 함수의 범위를 지정할지, 아니면 기본 버킷을 사용할지에 따라 다음 패턴 중 하나를 사용합니다.

// scope handler to a specific bucket, using a string parameter
export archivedbucket = onObjectArchived("myBucket", (event) => {
  //…
});

// scope handler to a specific bucket, using storage options parameter
export archivedopts = onObjectArchived({ bucket: "myBucket" }, (event) => {
  //…
});

반면에 이 썸네일 생성기 함수는 프로젝트의 기본 버킷으로 범위를 지정합니다.

exports.generateThumbnail = onObjectFinalized({cpu: 2}, async (event) => {
  // ...
});

함수 위치 설정

Cloud Storage 버킷 위치와 함수 위치 사이의 거리로 인해 상당한 네트워크 지연 시간이 발생할 수 있습니다. 또한 위치가 일치하지 않으면 배포가 실패할 수 있습니다. 이러한 상황을 방지하려면 다음 방법 중 하나로 버킷/트리거 위치와 일치하도록 함수 위치를 지정합니다.

  • 함수 위치가 트리거 위치와 동일합니다.
  • 함수 위치가 트리거 위치 내에 있습니다(트리거 리전이 이중/멀티 리전인 경우).
  • 트리거 리전이 us-central1로 설정되어 있으면 함수가 모든 위치에 있을 수 있습니다.

Cloud Storage 이벤트 처리

Cloud Storage는 다음 이벤트를 지원합니다.

Cloud Storage 이벤트에 응답하는 다음 핸들러를 사용할 수 있습니다.

  • onObjectArchived: 버킷에서 객체 버전 관리를 사용 설정한 경우에만 전송됩니다. 이 이벤트는 객체 버전을 보관처리했거나 이름이 동일한 객체를 업로드하여 덮어씀으로써 객체의 서비스 중인 버전이 보관처리 버전이 되었음을 나타냅니다.
  • onObjectDeleted: 객체가 영구 삭제되면 전송됩니다. 여기에는 덮어썼거나 버킷 수명 주기 구성에 따라 삭제된 객체가 포함됩니다. 객체 버전 관리를 사용 설정한 버킷에서는 객체를 보관처리(onArchive 참조)할 때 storage.objects.delete 메서드를 통해 보관처리했더라도 이 이벤트가 전송되지 않습니다.
  • onObjectFinalized: 버킷에서 새 객체나 기존 객체의 새 세대를 만들면 전송됩니다. 여기에는 기존 객체 복사나 재작성이 포함됩니다. 실패한 업로드는 이 이벤트를 트리거하지 않습니다.
  • onMetadataUpdated: 기존 객체의 메타데이터가 변경되면 전송됩니다.

Cloud Storage 객체 속성 액세스

Cloud Functions는 업데이트된 파일의 size 및 contentType과 같은 여러 Cloud Storage 객체 속성을 노출합니다. 객체의 메타데이터가 변경될 때마다 metageneration 속성이 증가합니다. 새 객체의 경우 metageneration 값이 1입니다.

const fileBucket = event.data.bucket; // Storage bucket containing the file.
const filePath = event.data.name; // File path in the bucket.
const contentType = event.data.contentType; // File content type.
index.js

썸네일 이미지 생성 샘플에서는 이러한 속성 중 일부를 사용하여 함수에서 반환하는 종료 사례를 감지합니다.

// Exit if this is triggered on a file that is not an image.
if (!contentType.startsWith("image/")) {
  return logger.log("This is not an image.");
}
// Exit if the image is already a thumbnail.
const fileName = path.basename(filePath);
if (fileName.startsWith("thumb_")) {
  return logger.log("Already a Thumbnail.");
}
index.js

파일 다운로드, 변환, 업로드

간혹 Cloud Storage에서 파일을 다운로드할 필요가 없는 경우도 있습니다. 하지만 Cloud Storage에 저장된 파일로 썸네일 이미지를 생성하는 것과 같은 집중적인 작업을 수행하려면 함수 인스턴스(즉, 코드를 실행하는 가상 머신)에 파일을 다운로드해야 합니다.

객체를 간편하게 다운로드하고 Cloud Storage에 다시 업로드하려면 npm install --save @google-cloud/storage를 사용하여 Google Cloud Storage 패키지를 설치하고 가져옵니다. 자바스크립트 프로미스를 사용해 샘플의 썸네일 이미지 처리 작업과 같은 외부 프로세스를 처리하려면 child-process-promise도 가져옵니다.

const {onObjectFinalized} = require("firebase-functions/v2/storage");

const {initializeApp} = require("firebase-admin/app");
const {getStorage} = require("firebase-admin/storage");
const logger = require("firebase-functions/logger");
const path = require("path");

// library for image resizing
const sharp = require("sharp");

initializeApp();
index.js

Cloud Functions 인스턴스의 임시 디렉터리에 파일을 다운로드하려면 gcs.bucket.file(filePath).download를 사용합니다. 이 위치에서 필요에 따라 파일을 처리한 다음 Cloud Storage에 업로드할 수 있습니다. 비동기 작업을 수행하는 경우 콜백에서 자바스크립트 프로미스를 반환해야 합니다.

예: 이미지 변환

Cloud Functions를 ImageMagick과 같은 이미지 처리 프로그램과 함께 사용하면 그래픽 이미지 파일을 조작할 수 있습니다. 다음은 업로드된 이미지 파일의 썸네일 이미지를 만드는 방법의 예시입니다.

// Download file into memory from bucket.
const bucket = getStorage().bucket(fileBucket);
const downloadResponse = await bucket.file(filePath).download();
const imageBuffer = downloadResponse[0];
logger.log("Image downloaded!");

// Generate a thumbnail using sharp.
const thumbnailBuffer = await sharp(imageBuffer).resize({
  width: 200,
  height: 200,
  withoutEnlargement: true,
}).toBuffer();
logger.log("Thumbnail created");

// Prefix 'thumb_' to file name.
const thumbFileName = `thumb_${fileName}`;
const thumbFilePath = path.join(path.dirname(filePath), thumbFileName);

// Upload the thumbnail.
const metadata = {contentType: contentType};
await bucket.file(thumbFilePath).save(thumbnailBuffer, {
  metadata: metadata,
});
return logger.log("Thumbnail uploaded!");
index.js

이 코드는 ImageMagick 명령줄 프로그램 convert를 실행하여 임시 디렉터리에 저장된 이미지의 200x200 썸네일 이미지를 만든 다음 다시 Cloud Storage에 업로드합니다.

자세한 내용은 전체 Google Cloud Storage 트리거 문서를 참조하세요.