Google Storage 파일시스템
이 어댑터는 Google Storage를 파일시스템으로 사용할 수 있게 해줍니다.
이는 별도로 설치해야 하는 @deepkit/filesystem-google의 일부입니다.
npm install @deepkit/filesystem-google
사용법
import { Filesystem } from '@deepkit/filesystem'; import { FilesystemGoogleAdapter } from '@deepkit/filesystem-google'; const adapter = new FilesystemGoogleAdapter({ bucket: 'my-bucket', path: 'starting-path/', // 선택 사항 projectId: '...', keyFilename: 'path/to/service-account-key.json' }); const filesystem = new Filesystem(adapter);
참고: 자격 증명을 코드에 직접 저장하지 마세요. 대신 환경 변수 또는 앱 구성을 사용하세요.
이 어댑터는 @google-cloud/storage의 Google Storage 클라이언트를 사용합니다. 해당 클라이언트의 모든 구성 옵션을 어댑터 생성자에 전달할 수 있습니다.
권한
파일이 생성될 때 어떤 가시성(visibility)을 가질지 구성할 수 있습니다.
const filesystem = new Filesystem(adapter); filesystem.write('/hello-public.txt', 'hello world', 'public'); filesystem.write('/hello-private.txt', 'hello world', 'private');
파일 /hello-public.txt는 ACL public: true로 생성되며, URL을 통해 누구나 읽을 수 있습니다. 해당 URL은 filesystem.publicUrl을 사용해 가져올 수 있습니다.
const url = filesystem.publicUrl('/hello-public.txt'); // https://storage.googleapis.com/my-bucket/starting-path/hello-public.txt
visibility를 사용하려면 Google Storage 버킷에서 객체 기반(object-based) ACL을 활성화해야 합니다.