Bun on AWS with SST

SST를 사용하여 AWS에 Bun 앱을 생성하고 배포하기

AWS에서 SST와 함께 Bun 사용하기

Bun으로 앱을 만들고, 파일 업로드를 위한 S3 버킷을 추가한 다음, SST를 사용해 AWS에 컨테이너로 배포해 보겠습니다.

예제

Bun과 관련된 몇 가지 다른 예제도 참고할 수 있습니다.

1. 프로젝트 생성

Bun 앱을 만들어 보겠습니다.

mkdir aws-bun && cd aws-bun
bun init -y

Init Bun Serve

index.ts 파일을 다음 코드로 교체하세요.

const server = Bun.serve({
  async fetch(req) {
    const url = new URL(req.url);

    if (url.pathname === "/" && req.method === "GET") {
      return new Response("Hello World!");
    }

    return new Response("404!");
  },
});

console.log(`Listening on ${server.url}`);

이 코드는 기본적으로 포트 3000에서 HTTP 서버를 시작합니다.

스크립트 추가하기

package.json에 다음 내용을 추가하세요.

"scripts": {
  "dev": "bun run --watch index.ts"
},

이렇게 하면 파일 변경을 감시하는 dev 스크립트가 추가됩니다.

SST 초기화

이제 앱에서 SST를 초기화해 보겠습니다.

bunx sst init
bun install

이 명령어를 실행하면 프로젝트 루트에 sst.config.ts 파일이 생성되고 SST가 설치됩니다.

2. 서비스 추가하기

Bun 앱을 배포하기 위해 Amazon ECS와 함께 AWS Fargate 컨테이너를 추가해 보겠습니다. sst.config.ts 파일을 업데이트하세요.

async run() {
  const vpc = new sst.aws.Vpc("MyVpc");

  const cluster = new sst.aws.Cluster("MyCluster", { vpc });
  cluster.addService("MyService", {
    loadBalancer: {
      ports: [{ listen: "80/http", forward: "3000/http" }],
    },
    dev: {
      command: "bun dev",
    },
  });
}

이 코드는 VPC와 ECS 클러스터를 생성하고, 여기에 Fargate 서비스를 추가합니다.

dev.command는 SST에게 개발 모드에서 Bun 앱을 로컬에서 실행하도록 지시합니다.

개발 모드 시작

개발 모드를 시작하려면 다음 명령어를 실행하세요. 이 명령어는 SST와 여러분의 Bun 앱을 시작합니다.

bun sst dev

실행이 완료되면 사이드바에서 MyService를 클릭하고 브라우저에서 Bun 앱을 열어보세요.

3. S3 버킷 추가하기

파일 업로드를 위해 S3 버킷을 추가해 보겠습니다. Vpc 컴포넌트 아래에 다음 코드를 sst.config.ts 파일에 추가하세요.

const bucket = new sst.aws.Bucket("MyBucket");

버킷 연결하기

이제 버킷을 컨테이너에 연결합니다.

cluster.addService("MyService", {
  // ...
  link: [bucket],
});

이렇게 하면 Bun 앱에서 버킷을 참조할 수 있습니다.

4. 파일 업로드

/ 라우트로 POST 요청을 보내 S3 버킷에 파일을 업로드하려고 합니다. index.ts 파일의 Hello World 라우트 아래에 이를 추가해 보겠습니다.

if (url.pathname === "/" && req.method === "POST") {
  const formData = await req.formData();
  const file = formData.get("file")! as File;
  const params = {
    Bucket: Resource.MyBucket.name,
    ContentType: file.type,
    Key: file.name,
    Body: file,
  };
  const upload = new Upload({
    params,
    client: s3,
  });
  await upload.done();

  return new Response("File uploaded successfully.");
}

필요한 모듈을 임포트합니다. 아래 추가 모듈을 사용할 것입니다.

import { Resource } from "sst";
import {
  S3Client,
  GetObjectCommand,
  ListObjectsV2Command,
} from "@aws-sdk/client-s3";
import { Upload } from "@aws-sdk/lib-storage";
import { getSignedUrl } from "@aws-sdk/s3-request-presigner";

const s3 = new S3Client();

그리고 npm 패키지를 설치합니다.

bun install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner

5. 파일 다운로드

S3 버킷에서 가장 최신 파일을 다운로드할 수 있는 /latest 라우트를 추가하겠습니다. 이 코드를 index.ts 파일의 업로드 라우트 아래에 추가합니다.

if (url.pathname === "/latest" && req.method === "GET") {
  const objects = await s3.send(
    new ListObjectsV2Command({
      Bucket: Resource.MyBucket.name,
    }),
  );
  const latestFile = objects.Contents!.sort(
    (a, b) =>
      (b.LastModified?.getTime() ?? 0) - (a.LastModified?.getTime() ?? 0),
  )[0];
  const command = new GetObjectCommand({
    Key: latestFile.Key,
    Bucket: Resource.MyBucket.name,
  });
  return Response.redirect(await getSignedUrl(s3, command));
}

앱 테스트하기

파일을 업로드하려면 프로젝트 루트에서 다음 명령어를 실행하세요.

curl -F file=@package.json http://localhost:3000/

이 명령어는 package.json 파일을 업로드합니다. 이제 브라우저에서 http://localhost:3000/latest로 이동하면 방금 업로드한 파일을 확인할 수 있습니다.

SST Bun 앱 파일 업로드

6. 앱 배포하기

앱을 배포하기 위해 먼저 Dockerfile을 추가합니다.

FROM oven/bun

COPY bun.lockb .
COPY package.json .

RUN bun install --frozen-lockfile

COPY . .

EXPOSE 3000
CMD ["bun", "index.ts"]

이 설정은 매우 기본적인 형태입니다. 더 최적화된 Dockerfile을 원한다면 Bun 문서를 참고하세요.

또한 루트 디렉토리에 .dockerignore 파일을 추가합니다.

node_modules
.git
.gitignore
README.md
Dockerfile*

이제 Docker 이미지를 빌드하고 배포하려면 다음 명령어를 실행합니다:

bun sst deploy --stage production

여기서는 어떤 스테이지 이름을 사용해도 되지만, 프로덕션용으로 새로운 스테이지를 만드는 것이 좋습니다. 이 명령어는 Bun 앱이 Fargate 서비스로 배포된 URL을 제공합니다.

✓  Complete
   MyService: http://prod-MyServiceLoadBalanc-491430065.us-east-1.elb.amazonaws.com

축하합니다! 이제 여러분의 앱이 라이브 상태가 되었습니다!

콘솔 연결하기

다음 단계로 SST 콘솔을 설정하여 앱을 _git push로 배포_하고 로그를 확인할 수 있습니다.

SST 콘솔 자동 배포

무료 계정을 생성하고 AWS 계정에 연결할 수 있습니다.