NestJS on AWS with SST

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

NestJS를 AWS에 SST로 배포하기

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

시작하기 전에 AWS 자격 증명을 설정하세요.

또한 Node 22.12가 설치되어 있는지 확인하세요. 또는 --experimental-require-module 플래그를 설정하세요. 이렇게 하면 NestJS가 SST SDK를 가져올 수 있습니다.

예제

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

NestJS와 Redis를 사용한 조회수 카운터 만들기

1. 프로젝트 생성

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

nest new aws-nestjs-container
cd aws-nestjs-container

패키지 매니저로 npm을 선택합니다.

SST 초기화

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

npx sst@latest init
npm install

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

sst.config.ts 파일의 타입이 인식되도록 하려면, tsconfig.json 파일에 다음 내용을 추가하세요.

{
 "include": ["src/**/*", "test/**/*", "sst-env.d.ts"]
}

2. 서비스 추가하기

Nest 앱을 배포하기 위해 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: "npm run start:dev",
    },
  });
}

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

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

개발 모드 시작

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

npx sst dev

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

3. S3 버킷 추가하기

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

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

버킷 연결하기

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

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

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

4. 파일 업로드

/ 라우트로 POST 요청을 보내 S3 버킷에 파일을 업로드하려고 합니다. src/app.controller.ts 파일의 getHello 메서드 아래에 다음 코드를 추가합니다.

@Post()
@UseInterceptors(FileInterceptor('file'))
async uploadFile(@UploadedFile() file: Express.Multer.File): Promise<string> {
  const params = {
    Bucket: Resource.MyBucket.name,
    ContentType: file.mimetype,
    Key: file.originalname,
    Body: file.buffer,
  };

  const upload = new Upload({
    params,
    client: s3,
  });

  await upload.done();

  return '파일 업로드가 성공적으로 완료되었습니다.';
}

필요한 모듈을 임포트합니다. 아래 추가 모듈도 함께 사용합니다.

import {
  S3Client,
  GetObjectCommand,
  ListObjectsV2Command,
} from '@aws-sdk/client-s3';
import { Resource } from 'sst';
import { Express } from 'express';
import { Upload } from '@aws-sdk/lib-storage';
import { FileInterceptor } from '@nestjs/platform-express';
import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
import { Post, Redirect, UploadedFile, UseInterceptors } from '@nestjs/common';

const s3 = new S3Client({});

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

npm install -D @types/multer
npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner

5. 파일 다운로드

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

@Get('latest')
@Redirect('/', 302)
async getLatestFile() {
  const objects = await s3.send(
    new ListObjectsV2Command({
      Bucket: Resource.MyBucket.name,
    }),
  );

  const latestFile = objects.Contents.sort(
    (a, b) => b.LastModified.getTime() - a.LastModified.getTime(),
  )[0];

  const command = new GetObjectCommand({
    Key: latestFile.Key,
    Bucket: Resource.MyBucket.name,
  });
  const url = await getSignedUrl(s3, command);

  return { url };
}

앱 테스트하기

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

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

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

5. 앱 배포하기

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

FROM node:22

WORKDIR /usr/src/app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

EXPOSE 3000
CMD ["node", "dist/main"]

이 파일은 Docker 이미지 안에서 Nest 앱을 빌드합니다.

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

dist
node_modules

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

npx sst deploy --stage production

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

✓  Complete
   MyService: http://jayair-MyServiceLoadBala-592628062.us-east-1.elb.amazonaws.com

콘솔 연결하기

다음 단계로, 여러분은 SST 콘솔을 설정하여 _git push로 앱을 배포_하고 문제를 모니터링할 수 있습니다.

SST 콘솔 자동 배포

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