Skip to content
SST
Blog Docs Console Examples
22K

Hono on AWS with SST

SST를 사용하여 AWS에서 Hono API를 생성하고 배포합니다.

SST로 AWS에 Hono 배포하기

SST를 사용해 Hono 앱을 AWS에 배포하는 방법은 두 가지입니다.

  1. 서버리스
  2. 컨테이너

아래에서 두 가지 방법을 모두 사용해 간단한 앱을 만들어 보겠습니다.

예제

Hono의 다른 예제도 참고할 수 있습니다.

서버리스

서버리스 Hono API를 구축하고, 파일 업로드를 위한 S3 버킷을 추가한 다음, Lambda 함수를 사용해 배포할 예정입니다.

시작하기 전에 AWS 자격 증명을 설정해야 합니다.

1. 프로젝트 생성

앱을 만들어 보겠습니다.

Terminal window
npm create hono@latest aws-hono
cd aws-hono

aws-lambda 템플릿을 선택합니다.

SST 초기화

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

Terminal window
npx sst@latest init
npm install

기본값을 선택하고 AWS를 선택합니다. 이렇게 하면 프로젝트 루트에 sst.config.ts 파일이 생성됩니다.

2. API 추가하기

AWS Lambda를 사용하여 Hono API를 추가해 보겠습니다. sst.config.ts 파일을 업데이트하세요.

sst.config.ts
async run() {
  new sst.aws.Function("Hono", {
    url: true,
    handler: "src/index.handler",
  });
}

이 함수에 대해 URL을 활성화하고 있습니다.

개발 모드 시작

여러분의 앱을 개발 모드로 실행합니다. 이 명령어는 여러분의 함수를 Live로 실행합니다.

Terminal window
npx sst dev

이 명령어를 실행하면 API의 URL을 제공합니다.

✓  완료
   Hono: https://gyrork2ll35rsuml2yr4lifuqu0tsjft.lambda-url.us-east-1.on.aws

3. S3 버킷 추가하기

파일 업로드를 위해 S3 버킷을 추가해 보겠습니다. sst.config.ts 파일을 업데이트하세요.

sst.config.ts
const bucket = new sst.aws.Bucket("MyBucket");
버킷 연결하기

이제 버킷을 API에 연결합니다.

sst.config.ts
new sst.aws.Function("Hono", {
  url: true,
  link: [bucket],
  handler: "src/index.handler",
});

4. 파일 업로드

우리 API의 / 라우트가 파일을 S3 버킷에 업로드할 수 있는 사전 서명된 URL을 생성하도록 만들고 싶습니다. src/index.ts 파일의 Hello Hono 라우트를 다음 코드로 교체하세요.

src/index.ts
app.get('/', async (c) => {
  const command = new PutObjectCommand({
    Key: crypto.randomUUID(),
    Bucket: Resource.MyBucket.name,
  });


  return c.text(await getSignedUrl(s3, command));
});

npm 패키지를 설치하세요.

Terminal window
npm install @aws-sdk/client-s3 @aws-sdk/s3-request-presigner

그런 다음 관련 임포트를 추가하세요. 아래 추가된 임포트를 사용할 것입니다.

src/index.ts
import { Resource } from 'sst'
import { getSignedUrl } from '@aws-sdk/s3-request-presigner'
import {
  S3Client,
  GetObjectCommand,
  PutObjectCommand,
  ListObjectsV2Command,
} from '@aws-sdk/client-s3'


const s3 = new S3Client();

5. 파일 다운로드

API의 /latest 라우트가 S3 버킷에 업로드된 가장 최신 파일을 다운로드할 수 있는 사전 서명된 URL을 생성하도록 만들고 싶습니다. 이를 src/index.ts의 라우트에 추가하세요.

src/index.ts
app.get('/latest', async (c) => {
  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 c.redirect(await getSignedUrl(s3, command));
});
앱 테스트하기

프로젝트 루트에서 파일을 업로드해 보겠습니다. 여러분의 API URL을 사용해야 합니다.

Terminal window
curl --upload-file package.json "$(curl https://gyrork2ll35rsuml2yr4lifuqu0tsjft.lambda-url.us-east-1.on.aws)"

이제 브라우저에서 https://gyrork2ll35rsuml2yr4lifuqu0tsjft.lambda-url.us-east-1.on.aws/latest로 이동하면 방금 업로드한 파일을 다운로드할 수 있습니다.

6. 앱 배포하기

이제 여러분의 앱을 배포해 보겠습니다.

Terminal window
npx sst deploy --stage production

여기서는 어떤 스테이지 이름을 사용해도 되지만, 프로덕션용으로 새로운 스테이지를 만드는 것이 좋습니다.

컨테이너

Hono API를 생성하고 파일 업로드를 위한 S3 버킷을 추가한 후, Cluster 컴포넌트를 사용해 컨테이너에 배포할 예정입니다.

시작하기 전에 AWS 자격 증명을 설정했는지 확인하세요.

1. 프로젝트 생성하기

먼저 앱을 만들어 보겠습니다.

Terminal window
npm create hono@latest aws-hono-container
cd aws-hono-container

nodejs 템플릿을 선택합니다.

Init SST_8fSrqB7nePgqhto3d4ZPkw

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

Terminal window
npx sst@latest init
npm install

기본값을 선택하고 AWS를 선택합니다. 이렇게 하면 프로젝트 루트에 sst.config.ts 파일이 생성됩니다.

2. 서비스 추가하기

Hono 앱을 컨테이너로 배포하기 위해 AWS Fargate와 Amazon ECS를 사용합니다. 아래 코드에서 run 함수를 대체합니다.

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 dev",
    },
  });
}

이 코드는 VPC와 Fargate 서비스가 포함된 ECS 클러스터를 생성합니다.

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

개발 모드 시작

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

Terminal window
npx sst dev

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

3. S3 버킷 추가하기

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

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

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

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

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

4. 파일 업로드_BpcvN6XAeUBNmdhJgVAaDe

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

src/index.ts
app.post('/', async (c) => {
  const body = await c.req.parseBody();
  const file = body['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 c.text('파일 업로드가 완료되었습니다.');
});

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

src/index.ts
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 패키지를 설치합니다.

Terminal window
npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner

5. 파일 다운로드

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

src/index.ts
app.get('/latest', async (c) => {
  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 c.redirect(await getSignedUrl(s3, command));
});

앱 테스트하기

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

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

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

6. 앱 배포하기_LBBhjoRXBVy3nbXb9NXgZ2

앱을 배포하기 위해 먼저 Dockerfile을 추가합니다. 이 파일은 위에서 작성한 build 스크립트를 실행하여 앱을 빌드합니다.

Dockerfile
FROM node:lts-alpine AS base


FROM base AS builder
RUN apk add --no-cache gcompat
WORKDIR /app
COPY package*json tsconfig.json src ./
 # 생성된 타입 파일 복사
 COPY sst-env.d.ts* ./
RUN npm ci && \
  npm run build && \
  npm prune --production


FROM base AS runner
WORKDIR /app
RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 hono
COPY --from=builder --chown=hono:nodejs /app/node_modules /app/node_modules
COPY --from=builder --chown=hono:nodejs /app/dist /app/dist
COPY --from=builder --chown=hono:nodejs /app/package.json /app/package.json


USER hono
EXPOSE 3000
CMD ["node", "/app/dist/index.js"]

이렇게 하면 Hono 앱이 Docker 이미지로 빌드됩니다.

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

.dockerignore
node_modules
.git

TypeScript 파일을 컴파일하려면 tsconfig.json에 다음 내용을 추가해야 합니다.

tsconfig.json
{
  "compilerOptions": {
    // ...
    "outDir": "./dist"
  },
  "exclude": ["node_modules"]
}

TypeScript를 설치합니다.

Terminal window
npm install typescript --save-dev

그리고 package.json에 build 스크립트를 추가합니다.

package.json
"scripts": {
  // ...
  "build": "tsc"
}

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

Terminal window
npx sst deploy --stage production

여기서는 어떤 스테이지 이름을 사용해도 되지만, 프로덕션을 위해 새로운 스테이지를 만드는 것이 좋습니다. 이렇게 하면 Hono 앱이 Fargate 서비스로 배포된 URL을 얻을 수 있습니다.

Terminal window
✓  완료
   MyService: http://prod-MyServiceLoadBalanc-491430065.us-east-1.elb.amazonaws.com

콘솔 연결하기

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

SST 콘솔 자동 배포

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