콘텐츠 대표 이미지 - 서버리스 풀스택, 이제 혼자서도 '쌉가능'한 시대!

AWS Amplify로 날아오르기 🚀

서버리스 풀스택, 이제 혼자서도 '쌉가능'한 시대!

안녕하세요, 개발자 동지 여러분! 👋
오늘도 수많은 에러와 사투를 벌이며, ‘이 기능 하나 추가하자고 또 서버를 만져야 하나…’ 깊은 한숨 쉬고 계신가요?
혹은 멋진 아이디어는 있는데, 프론트엔드 개발만 해봐서 백엔드와 인프라는 막막하게 느껴지시나요?

매일같이 반복되는 서버 설정, 데이터베이스 연결, 인증 로직 구현, 배포 파이프라인 구축…
생각만 해도 머리가 지끈거리는 이 모든 과정을 누군가 ‘요술봉’처럼 뿅! 하고 해결해준다면 얼마나 좋을까요?

바로 그 요술봉이 여기 있습니다.
오늘 우리가 함께 탐험할 세상의 이름은 바로 AWS Amplify입니다.

Amplify는 마치 레고 블록처럼, 복잡하고 거대한 AWS의 서비스들을 착착 조립해서
근사한 풀스택 애플리케이션을 순식간에 만들어주는 마법 같은 도구입니다.
서버 관리에 대한 걱정 없이, 오롯이 ‘만드는 즐거움’에만 집중할 수 있게 해주는 거죠.

이 글은 프론트엔드 개발자지만 풀스택에 도전하고 싶은 분, 1인 개발자로 MVP(최소 기능 제품)를 빠르게 만들고 싶은 분,
그리고 ‘서버리스’라는 단어는 들어봤지만 어디서부터 시작해야 할지 막막했던 모든 분들을 위한 친절한 안내서가 될 거예요.
친구에게 설명하듯, 하나하나 차근차근 함께 나아가 봅시다. 준비되셨나요? 😉

CHAPTER 1: 왜 우리는 서버리스와 Amplify에 열광하는가? 🤔

본격적인 여정을 떠나기 전에, 우리가 왜 ‘서버리스(Serverless)’라는 개념에 주목해야 하고,
수많은 도구 중에서도 왜 하필 ‘AWS Amplify’인지 그 이유를 확실히 짚고 넘어가야겠죠?
이유를 알면, 배우는 과정이 훨씬 더 즐거워질 테니까요.

서버리스: 서버가 없다고? 진짜?

‘서버리스(Serverless)’라는 말을 처음 들으면 대부분 고개를 갸웃합니다.
“아니, 서버 없이 어떻게 웹사이트가 돌아가요?”
물론, 정말로 물리적인 서버가 사라졌다는 뜻은 아닙니다. 어딘가에 있는 데이터 센터에서는 여전히 컴퓨터들이 열심히 돌아가고 있죠.

핵심은 이것입니다: “우리가 더 이상 서버를 직접 관리하지 않아도 된다.”

기존 방식(전통적인 아키텍처)에서는 우리가 직접 서버 컴퓨터(물리적이든 가상이든)를 골라서 세팅하고, 운영체제를 설치하고, 보안 패치를 하고, 트래픽이 몰리면 서버 용량을 늘리는 ‘스케일링’ 작업까지 도맡아야 했습니다.
마치 식당을 차리는데, 요리뿐만 아니라 주방 설비 관리, 전기 공사, 수도 배관까지 신경 써야 하는 상황과 비슷하죠. 셰프는 요리에만 집중하고 싶은데 말이에요!

서버리스는 이 모든 귀찮은 인프라 관리를 클라우드 제공업체(AWS, Google Cloud, Azure 등)에게 맡겨버리는 패러다임입니다.
우리는 그저 ‘이런 기능이 필요해’라고 외치며 코드(함수)만 작성해서 던져주면, 클라우드가 알아서 그 코드를 실행할 환경을 준비하고, 사용자가 요청할 때만 실행시켜 줍니다.

전통적인 아키텍처 vs 서버리스 아키텍처 전통적인 방식 (개발자가 서버 관리) Client (Browser) Web/App Server (EC2, Nginx, Tomcat) Database Server (RDS, MySQL) "서버 용량, 보안, 업데이트... 내가 다 신경 써야 해 😥" 서버리스 방식 (AWS가 알아서 관리) Client (Browser) Managed AWS Services (Amplify가 연결) 인증 (Cognito) API/DB (AppSync/DynamoDB) 파일 저장 (S3) 서버 로직 (Lambda) 배포/호스팅 (Amplify Hosting) "나는 코드만 짜면 돼! 나머진 AWS가 다 해줌 😎"

이게 왜 혁신적이냐면요:

1. 비용 효율성 (돈이 절약돼요 💰):
전통적인 서버는 24시간 내내 켜놓아야 하니, 사용자가 있든 없든 계속 돈이 나갑니다. 하지만 서버리스는 코드가 ‘실행된 시간’만큼만, 딱 그만큼만 비용을 지불합니다. 새벽 시간에 아무도 우리 웹사이트를 방문하지 않는다면? 비용은 거의 0에 가깝죠.

2. 자동 스케일링 (트래픽 폭주도 걱정 없어요 📈):
갑자기 우리 서비스가 대박 나서 수만 명이 동시에 몰려들면 어떡하죠? 전통적인 방식에서는 서버가 터지고, 부랴부랴 서버를 증설해야 합니다. 서버리스는? AWS가 알아서 순식간에 수천, 수만 개의 실행 환경을 복제해서 모든 요청을 처리해줍니다. 우리는 그저 행복한 비명을 지르며 지켜보기만 하면 됩니다.

3. 개발 생산성 향상 (칼퇴가 가능해져요 🏡):
인프라 관리에 쏟던 시간을 오롯이 비즈니스 로직과 사용자 경험(UX) 개선에만 집중할 수 있습니다. 이는 곧 더 빠른 개발 속도와 더 높은 퀄리티의 제품으로 이어지죠.

AWS Amplify: 복잡한 AWS를 위한 '통역사'

“좋아, 서버리스가 짱인 건 알겠어. 근데 AWS는 너무 복잡하고 어려운 거 아니야?”

네, 맞습니다. AWS는 정말 강력하지만, 그만큼 배워야 할 서비스와 개념이 산더미처럼 많습니다.
인증을 위해서는 Cognito와 IAM을, API를 위해서는 API Gateway와 Lambda, AppSync를, 데이터베이스를 위해서는 DynamoDB나 RDS를… 각각의 서비스를 따로 배우고 설정해서 서로 엮어주는 건 초심자에게 엄청난 장벽이죠.

바로 이 지점에서 AWS Amplify가 구원투수로 등판합니다. ⚾

Amplify는 이 복잡한 AWS 서비스들을 ‘인증’, ‘API’, ‘스토리지’와 같이 개발자가 이해하기 쉬운 카테고리로 묶고, 간단한 명령어 몇 줄로 이 모든 것을 자동으로 구성해주는 ‘프레임워크’이자 ‘툴체인(Toolchain)’입니다.

예를 들어 볼까요? 우리 앱에 로그인/회원가입 기능이 필요하다고 해봅시다.

Amplify가 없다면 (The Hard Way):

1. AWS 콘솔에 로그인해서 Cognito 서비스로 이동.
2. ‘사용자 풀(User Pool)’ 생성, 각종 보안 정책(비밀번호 복잡도 등) 설정.
3. ‘자격 증명 풀(Identity Pool)’ 생성, 인증/비인증 사용자에 대한 IAM 역할(Role) 설정.
4. 이 모든 것의 ID와 ARN(고유 식별자)을 복사.
5. 프론트엔드 코드에서 AWS SDK를 설치하고, 복사해온 값들로 초기화 설정.
6. SDK의 복잡한 API를 호출해서 로그인, 회원가입 UI와 로직을 한 땀 한 땀 직접 구현.

Amplify가 있다면 (The Easy Way):

1. 프로젝트 폴더의 터미널에서 `amplify add auth` 명령어 입력.
2. 몇 가지 간단한 질문(기본 설정으로 할래? 소셜 로그인 추가할래?)에 답하기.
3. `amplify push` 명령어 입력.
4. 프론트엔드 코드(React, Vue 등)에 Amplify UI 컴포넌트 한 줄 추가: ``

끝입니다. 정말이에요. 이것만으로도 완벽하게 작동하는 로그인, 회원가입, 비밀번호 찾기 UI와 기능이 뚝딱 만들어집니다. Amplify가 뒤에서 저 복잡한 과정들을 모두 자동으로 처리해준 거죠.

💡 Amplify의 세 가지 핵심 구성 요소

Amplify는 크게 세 가지로 이루어져 있어요. 이 세 친구만 기억하면 됩니다.

1. Amplify CLI (Command Line Interface): 터미널에서 `amplify add auth`처럼 명령어를 입력해서 AWS 백엔드 리소스를 만들고 관리하는 도구입니다. 우리의 요술봉이죠.

2. Amplify Libraries: 프론트엔드 코드(JavaScript, React, Vue, Swift, Android 등)에서 백엔드 기능과 쉽게 상호작용할 수 있도록 도와주는 코드 묶음(라이브러리)입니다. `Auth.signIn()`, `API.get()`처럼요.

3. Amplify Hosting (구 Amplify Console): 프론트엔드와 백엔드를 배포하고, CI/CD(지속적 통합/배포) 파이프라인을 구축해주는 서비스입니다. Git에 코드를 푸시하면 자동으로 빌드하고 배포해주죠.

결국 Amplify는 개발자가 AWS의 내부 동작 원리를 깊게 몰라도, ‘무엇을 하고 싶은지’에만 집중하여 강력한 서버리스 애플리케이션을 빠르게 구축할 수 있도록 돕는 생산성 부스터인 셈입니다.

CHAPTER 2: 여권과 비행기 티켓 준비 - 개발 환경 설정 ✈️

자, 이제 Amplify의 매력을 충분히 느꼈으니 직접 경험해볼 시간입니다.
본격적인 개발 여행을 떠나기 전에, 여권(AWS 계정)과 비행기 티켓(개발 도구)을 준비해야겠죠?
조금 귀찮을 수 있지만, 이 과정만 잘 마치면 정말 신나는 비행이 시작될 거예요.

필수 준비물 체크리스트

우리 컴퓨터에 아래 항목들이 준비되어 있는지 확인해 주세요.

1. AWS 계정: 당연히 AWS 서비스를 이용해야 하니 계정이 필요합니다. 없다면 지금 바로 만들어주세요! 가입 후 12개월 동안은 넉넉한 ‘프리티어’를 제공하니 부담 없이 시작할 수 있습니다. (단, 신용카드 등록이 필요해요!)

2. Node.js와 npm: Amplify CLI를 포함한 최신 웹 개발 도구들은 대부분 Node.js 기반으로 동작합니다. Node.js를 설치하면 패키지 매니저인 npm(또는 yarn)은 자동으로 함께 설치됩니다. 터미널에 `node -v`와 `npm -v`를 입력해서 버전이 잘 나오는지 확인해 보세요. (LTS 버전을 권장합니다.)

3. 코드 에디터: Visual Studio Code, WebStorm 등 여러분이 가장 좋아하는 코드 에디터를 준비해주세요.

Amplify CLI 설치 및 구성: 마법 지팡이 소환하기

이제 우리의 핵심 도구인 Amplify CLI를 설치할 차례입니다. 터미널(Windows는 PowerShell이나 WSL, Mac은 Terminal)을 열고 아래 명령어를 입력해주세요.

npm install -g @aws-amplify/cli

`-g` 옵션은 이 패키지를 내 컴퓨터 전역(global)에 설치하라는 의미입니다. 그래야 어느 프로젝트 폴더에서든 `amplify` 명령어를 사용할 수 있거든요.

설치가 완료되었다면, 이제 Amplify CLI가 내 AWS 계정에 접근할 수 있도록 권한을 부여해야 합니다.
이 과정은 마치 우리 집에 들어올 수 있는 열쇠를 만들어주는 것과 같아요. 아무나 들어오면 안 되니, ‘Amplify’라는 이름표를 가진 사람에게만 특별한 열쇠(Access Key)를 만들어 주는 거죠.

아래 명령어를 입력하면 이 과정이 시작됩니다.

amplify configure

이 명령어를 실행하면 다음과 같은 순서로 진행됩니다.

1. 브라우저가 열리면서 AWS 콘솔 로그인 창이 나타납니다. 로그인해주세요. 2. 로그인 후 다시 터미널로 돌아와 Enter 키를 누릅니다. 3. 리전(region)을 선택하라고 나옵니다. 우리나라는 `ap-northeast-2` (서울 리전)를 선택하는 것이 가장 빠르고 좋습니다. 키보드 화살표로 선택하고 Enter! 4. 이제 IAM(Identity and Access Management) 사용자를 만들 차례입니다. 터미널에 표시되는 사용자 이름을 입력하라고 하는데, 그냥 Enter를 눌러 기본값(`amplify-<랜덤문자>`)을 사용해도 좋습니다. 5. 다시 브라우저가 열리면서 IAM 사용자 만들기 페이지로 이동합니다. 대부분의 설정은 이미 채워져 있을 거예요. 그냥 ‘다음’ 버튼을 연타하다가 마지막 ‘사용자 만들기’ 버튼까지 눌러주세요. 6. 가장 중요한 단계입니다! 사용자가 만들어지면 ‘액세스 키(Access Key)’와 ‘비밀 액세스 키(Secret Access Key)’가 표시됩니다. 이 창은 딱 한 번만 보여주므로, 절대 닫지 말고 이 두 개의 키를 안전한 곳에 복사해두거나, .csv 파일을 다운로드 받아두세요. 7. 다시 터미널로 돌아오면 `accessKeyId`를 입력하라고 합니다. 방금 복사한 ‘액세스 키 ID’를 붙여넣고 Enter. 8. 다음으로 `secretAccessKey`를 입력하라고 합니다. ‘비밀 액세스 키’를 붙여넣고 Enter. 9. `Profile Name`을 정하라고 합니다. 여러 AWS 계정을 관리하는 게 아니라면 그냥 `default`로 두고 Enter를 누르는 게 편합니다.

⚠️ 잠깐! 액세스 키는 절대 노출 금지!

방금 생성한 Access Key와 Secret Access Key는 여러분의 AWS 계정을 제어할 수 있는 마스터키와 같습니다. 절대로 이 키들을 Git에 커밋하거나, 다른 사람에게 공개된 장소에 올리면 안 됩니다. 만약 실수로 노출되었다면, 즉시 AWS IAM 콘솔에서 해당 키를 비활성화하고 새로 만들어야 합니다. 그렇지 않으면 다음 달에 어마어마한 요금 폭탄을 맞을 수도 있어요! 💣

“Successfully set up the new user.” 라는 메시지가 보이면 모든 설정이 완료된 것입니다. 축하합니다! 🎉
이제 여러분은 Amplify라는 강력한 마법 지팡이를 손에 쥐었습니다.

첫 Amplify 프로젝트 시작하기: 우리의 아지트 건설

이제 실제 프로젝트를 만들어 볼까요? 여기서는 가장 대중적인 프론트엔드 프레임워크인 React를 기준으로 설명하겠습니다. (Vue, Angular, Next.js 등 다른 프레임워크도 과정은 거의 동일합니다.)

먼저, React 프로젝트를 생성합니다.

npx create-react-app my-amplify-app
cd my-amplify-app

프로젝트 폴더 안으로 들어왔다면, 드디어 Amplify에게 이 프로젝트를 관리해달라고 알려줄 차례입니다.

amplify init

이 명령어를 실행하면, Amplify CLI가 우리 프로젝트에 대한 몇 가지 질문을 할 거예요.

  • Enter a name for the project: 프로젝트 이름을 정합니다. 기본값(폴더 이름)을 사용하려면 그냥 Enter.
  • Enter a name for the environment: 개발 환경의 이름을 정합니다. 보통 `dev`, `prod`, `staging` 등으로 구분하는데, 처음에는 `dev`로 시작하는 것이 일반적입니다.
  • Choose your default editor: 주로 사용하는 코드 에디터를 선택합니다.
  • Choose the type of app that you're building: `javascript`를 선택합니다.
  • What javascript framework are you using: `react`를 선택합니다.
  • Source Directory Path: 소스 코드 경로입니다. `src`가 기본값이니 Enter.
  • Distribution Directory Path: 빌드 결과물이 생성되는 경로입니다. `build`가 기본값이니 Enter.
  • Build Command: 빌드 명령어입니다. `npm run-script build`가 기본값이니 Enter.
  • Start Command: 개발 서버 시작 명령어입니다. `npm run-script start`가 기본값이니 Enter.
  • Do you want to use an AWS profile? `Y`를 선택하고, 아까 `amplify configure`에서 설정한 프로필(`default`)을 선택합니다.

모든 질문에 답하고 나면, Amplify가 클라우드에서 우리 프로젝트를 위한 초기 설정 작업을 시작합니다.
잠시 기다리면 “Your project has been successfully initialized and connected to the cloud!” 라는 반가운 메시지가 나타납니다.

이제 프로젝트 폴더를 살펴보면 `amplify`라는 새로운 폴더와 `aws-exports.js`라는 파일이 생긴 것을 볼 수 있습니다.

  • `amplify/` 폴더: 우리가 앞으로 추가할 백엔드 기능(인증, API 등)에 대한 모든 설정과 템플릿이 저장되는 Amplify의 심장부입니다.
  • `aws-exports.js` 파일: 생성된 AWS 백엔드 리소스(Cognito User Pool ID, AppSync API 주소 등)의 정보가 담겨있는 파일입니다. 프론트엔드 라이브러리가 이 파일을 읽어서 백엔드와 통신하게 됩니다. (주의: 이 파일은 민감한 정보를 담고 있을 수 있으므로, `.gitignore`에 추가되어 있는지 꼭 확인하세요! `amplify init` 시 자동으로 추가됩니다.)

마지막으로, 우리 React 앱이 Amplify 백엔드와 통신할 수 있도록 관련 라이브러리를 설치하고, 앱의 진입점(`src/index.js` 또는 `src/App.js`)에서 Amplify를 구성하는 코드를 추가해야 합니다.

npm install aws-amplify @aws-amplify/ui-react

그리고 `src/index.js` 파일 상단에 아래 코드를 추가해주세요.

import { Amplify } from 'aws-amplify';
import awsExports from './aws-exports';
Amplify.configure(awsExports);

이것으로 모든 준비가 끝났습니다. 이제 우리는 기능이라는 블록을 하나씩 추가하며 우리만의 멋진 성을 지을 준비가 되었습니다.

CHAPTER 3: 핵심 기능 정복 - 진짜 앱 만들어보기 🛠️

자, 이제부터가 진짜 재미있는 부분입니다. 이론은 잠시 접어두고, 실제 앱을 만든다고 상상하며 Amplify의 핵심 기능들을 하나씩 정복해봅시다.
우리가 만들 앱은 간단한 ‘메모장 앱’이라고 가정해볼게요. 사용자는 회원가입/로그인을 하고, 자신만의 메모를 작성, 조회, 수정, 삭제할 수 있어야 합니다.

Part 1. 인증(Authentication): "누구신지?" 우리 앱의 문지기 만들기 🛡️

어떤 서비스든 가장 기본이 되는 것은 ‘사용자 관리’ 기능입니다. Amplify는 AWS Cognito라는 강력한 인증 서비스를 이용하여 이 과정을 놀라울 정도로 간단하게 만들어줍니다.

터미널에서 아래 명령어를 입력해봅시다.

amplify add auth

명령어를 실행하면, 어떤 방식으로 인증을 구성할지 묻는 질문이 나옵니다.

  • Default configuration: 가장 일반적인 이메일/비밀번호 기반의 로그인 설정을 빠르게 만들어줍니다. 처음이라면 이걸로 시작하는 게 제일 좋아요.
  • Default configuration with Social Provider (Federation): 이메일/비밀번호 로그인에 더해 구글, 페이스북, 애플 로그인 같은 소셜 로그인 기능을 추가해줍니다.
  • Manual configuration: 더 세세한 설정(예: 다중 인증(MFA), 비밀번호 정책 커스터마이징 등)을 하고 싶을 때 선택합니다.

우리는 `Default configuration`을 선택하고, 사용자가 어떻게 로그인할 것인지 묻는 질문에는 `Email`을 선택해봅시다. 나머지 질문들은 일단 기본값으로 두고 Enter를 눌러 진행합니다.

“Successfully added resource…” 메시지가 나오면 로컬에 인증 기능에 대한 설정이 추가된 것입니다. 하지만 아직 AWS 클라우드에 실제로 만들어진 것은 아니에요.

로컬에 쌓아둔 변경사항(‘인증 기능 추가해줘!’라는 요청)을 실제 클라우드에 반영하는 명령어가 바로 `push`입니다.

amplify push

`push` 명령어는 현재 로컬의 Amplify 설정과 클라우드의 상태를 비교해서 변경된 부분을 보여줍니다. ‘Auth’ 카테고리에 ‘Create’라고 표시된 것을 볼 수 있죠. `Y`를 입력하고 Enter를 누르면 Amplify가 AWS CloudFormation이라는 기술을 사용해서 필요한 모든 AWS 리소스(Cognito User Pool, Identity Pool 등)를 자동으로 생성하기 시작합니다.

커피 한 잔 마시고 오면 ☕ 모든 작업이 완료되어 있을 겁니다.

이제 이 강력한 인증 기능을 우리 React 앱에 붙여볼까요? `src/App.js` 파일을 열고 아래와 같이 수정해봅시다.

import './App.css';
import { Authenticator } from '@aws-amplify/ui-react';
import '@aws-amplify/ui-react/styles.css';

function App() {
  return (
    <Authenticator>
      {({ signOut, user }) => (
        <main>
          <h1>안녕하세요, {user.username}님!</h1>
          <p>여기는 로그인해야만 볼 수 있는 페이지입니다.</p>
          <button onClick={signOut}>로그아웃</button>
        </main>
      )}
    </Authenticator>
  );
}

export default App;

이게 다입니다! 믿어지시나요?

`npm start`로 개발 서버를 실행하고 브라우저에서 확인해보세요. 여러분이 직접 디자인하지 않았는데도 완벽하게 작동하는 회원가입, 로그인, 이메일 인증, 비밀번호 찾기 UI가 짠! 하고 나타날 겁니다.

`` 컴포넌트가 모든 것을 알아서 처리해줍니다. 사용자가 로그인하지 않은 상태라면 로그인 폼을 보여주고, 로그인을 성공적으로 마치면 그제서야 `{({ signOut, user }) => ( ... )}` 안에 있는 실제 앱 콘텐츠를 렌더링해줍니다. `user` 객체에는 로그인한 사용자의 정보가, `signOut` 함수에는 로그아웃 기능이 담겨있죠.

💡 UI 커스터마이징도 자유롭게!

Amplify UI 컴포넌트가 편리하긴 하지만, 디자인이 마음에 들지 않을 수도 있죠. 그럴 땐 `Auth` 라이브러리를 사용해서 직접 UI를 만들고 기능을 연동할 수 있습니다. 예를 들어, `Auth.signUp({ username, password, attributes: { email } })` 함수를 호출하면 회원가입이, `Auth.signIn(username, password)`를 호출하면 로그인이 되는 식이죠. 자유도가 매우 높습니다!

Part 2. API (GraphQL): 데이터의 고속도로 만들기 🚀

사용자 인증이 해결되었으니, 이제 메모를 저장하고 불러올 데이터베이스와 API가 필요합니다. Amplify는 여기서 가장 강력한 무기인 AWS AppSync를 꺼내 듭니다. AppSync는 완전 관리형 GraphQL 서비스입니다.

“GraphQL이 뭐죠?” 라고 묻는 분들을 위해 간단히 설명하자면, 클라이언트가 필요한 데이터의 구조를 직접 요청할 수 있는 똑똑한 API 방식입니다. REST API처럼 여러 개의 엔드포인트를 만들 필요 없이, 단 하나의 엔드포인트에서 원하는 모든 데이터를 유연하게 가져올 수 있죠.

백문이 불여일견! 바로 시작해봅시다.

amplify add api

몇 가지 질문이 나옵니다.

  • Please select from one of the below services: `GraphQL`을 선택합니다.
  • Provide an API name: API 이름을 정합니다. (예: `myamplifyappapi`)
  • Choose the default authorization type for the API: API에 누가 접근할 수 있는지 정하는 중요한 단계입니다. 우리는 로그인한 사용자만 메모를 작성할 수 있게 할 것이므로, `Amazon Cognito User Pool`을 선택합니다.
  • Do you want to configure advanced settings for the GraphQL API? 지금은 `No, I am done.`을 선택합니다.
  • Do you have an annotated GraphQL schema? `No`를 선택합니다.
  • Choose a schema template: `Single object with fields (e.g., “Todo” model)`을 선택해서 예제 스키마를 만들어봅시다.
  • Do you want to edit the schema now? `Yes`를 선택합니다.

마지막에 `Yes`를 선택하면 코드 에디터가 열리면서 `amplify/backend/api/<내 API이름>/schema.graphql` 파일이 나타납니다. 이 파일이 바로 우리 데이터베이스의 설계도입니다.

기본으로 생성된 `Todo` 모델을 우리 ‘메모장 앱’에 맞게 `Note` 모델로 수정해봅시다.

# schema.graphql

# @model: 이 타입을 데이터베이스 테이블로 만들어줘! (DynamoDB)
# @auth: 이 데이터에 대한 접근 권한을 설정해줘!
# 'owner'는 '내가 생성한 데이터는 나만 CRUD 할 수 있다'는 규칙입니다.
type Note @model @auth(rules: [{ allow: owner }]) {
  id: ID!
  name: String!
  description: String
}

여기서 `@model`과 `@auth` 같은 골뱅이(`@`)로 시작하는 단어들을 ‘디렉티브(Directive)’라고 부릅니다. Amplify에게 보내는 특별한 지시어죠.

  • `@model`: “이 `Note`라는 타입을 보고, AWS DynamoDB에 `Note` 테이블을 만들어줘. 그리고 이 테이블에 대한 기본적인 생성(Create), 조회(Read), 수정(Update), 삭제(Delete)를 위한 GraphQL API 코드(쿼리, 뮤테이션, 구독)도 자동으로 생성해줘!” 라는 뜻입니다.
  • `@auth(rules: [{ allow: owner }])`: “이 `Note` 데이터는 데이터를 생성한 ‘소유자(owner)’만 접근할 수 있도록 권한 설정을 해줘!” 라는 뜻입니다. Amplify가 알아서 Cognito의 사용자 정보와 데이터를 연결해서, A라는 사용자가 만든 메모는 B라는 사용자가 볼 수 없도록 막아줍니다. 정말 강력하죠?

스키마 파일을 저장하고 닫은 뒤, 터미널에서 다시 `amplify push`를 실행합니다.

amplify push

Amplify가 변경된 스키마를 분석해서 필요한 GraphQL API를 생성할 것인지 물어볼 겁니다. `Y`를 눌러 진행하면, Amplify는 AppSync API 엔드포인트, DynamoDB 테이블, 그리고 이 둘을 연결하는 모든 복잡한 로직(리졸버)을 자동으로 만들어줍니다.

배포가 완료되면, 이제 프론트엔드에서 이 API를 사용해볼 시간입니다.
`amplify push`가 성공적으로 끝나면 `src/graphql` 폴더에 `queries.js`, `mutations.js`, `subscriptions.js` 파일들이 자동으로 생성된 것을 볼 수 있습니다. Amplify가 우리 스키마를 보고 필요한 GraphQL 요청 코드를 미리 만들어준 것이죠.

이제 `src/App.js` 파일을 다시 수정해서 메모를 생성하고, 목록을 불러오는 기능을 추가해봅시다.

import './App.css';
import { Authenticator } from '@aws-amplify/ui-react';
import '@aws-amplify/ui-react/styles.css';

import { useState, useEffect } from 'react';
import { API } from 'aws-amplify';
import { listNotes } from './graphql/queries'; // 자동 생성된 쿼리
import { createNote as createNoteMutation, deleteNote as deleteNoteMutation } from './graphql/mutations'; // 자동 생성된 뮤테이션

function App() {
  const [notes, setNotes] = useState([]);

  useEffect(() => {
    fetchNotes();
  }, []);

  async function fetchNotes() {
    const apiData = await API.graphql({ query: listNotes });
    setNotes(apiData.data.listNotes.items);
  }

  async function createNote(event) {
    event.preventDefault();
    const form = new FormData(event.target);
    const data = {
      name: form.get('name'),
      description: form.get('description'),
    };
    await API.graphql({ query: createNoteMutation, variables: { input: data } });
    fetchNotes();
    event.target.reset();
  }

  async function deleteNote({ id }) {
    const newNotesArray = notes.filter(note => note.id !== id);
    setNotes(newNotesArray);
    await API.graphql({ query: deleteNoteMutation, variables: { input: { id } }});
  }

  return (
    <Authenticator>
      {({ signOut, user }) => (
        <div className="App">
          <h1>안녕하세요, {user.username}님!</h1>
          <form onSubmit={createNote}>
            <input name="name" placeholder="메모 제목" />
            <textarea name="description" placeholder="메모 내용" />
            <button type="submit">메모 생성</button>
          </form>
          <div>
            {notes.map(note => (
              <div key={note.id}>
                <h2>{note.name}</h2>
                <p>{note.description}</p>
                <button onClick={() => deleteNote(note)}>삭제</button>
              </div>
            ))}
          </div>
          <button onClick={signOut}>로그아웃</button>
        </div>
      )}
    </Authenticator>
  );
}

export default App;

코드가 조금 길어졌지만, 핵심은 `API.graphql()` 함수입니다.
이 함수 하나로 쿼리(데이터 조회), 뮤테이션(데이터 생성/수정/삭제)을 모두 처리할 수 있습니다.

  • `fetchNotes` 함수에서는 `listNotes` 쿼리를 날려 내가 작성한 모든 메모 목록을 가져옵니다.
  • `createNote` 함수에서는 `createNoteMutation`을 사용해서 새로운 메모를 생성합니다.
  • `deleteNote` 함수에서는 `deleteNoteMutation`으로 특정 메모를 삭제합니다.

이제 앱을 실행하고, 다른 계정으로 각각 로그인해서 메모를 작성해보세요. A 계정에서 작성한 메모는 B 계정에서는 보이지 않을 겁니다. `schema.graphql`에 추가했던 `@auth(rules: [{ allow: owner }])` 규칙이 마법처럼 작동하고 있는 것이죠!

Part 3. DataStore: 오프라인 지원과 실시간 동기화의 마법 🔄

“와, 이것만으로도 대단한데?” 라고 생각하셨다면, 아직 놀라긴 이릅니다. Amplify에는 `API` 카테고리보다 한 단계 더 진화한 DataStore라는 기능이 있습니다.

DataStore는 기본적으로 `API` 기능과 동일하게 AppSync를 사용하지만, 여기에 두 가지 강력한 마법을 더합니다.

1. 오프라인 우선(Offline First):
DataStore는 모든 데이터를 클라우드뿐만 아니라, 사용자의 브라우저나 모바일 기기 내부(IndexedDB, SQLite)에도 저장합니다. 그래서 인터넷이 끊겨도 앱에서 데이터를 읽고 쓰는 것이 가능합니다! 그리고 인터넷이 다시 연결되면, 그동안 변경된 내용을 알아서 클라우드와 동기화해줍니다. 지하철이나 비행기에서도 앱이 멈추지 않는 경험을 제공할 수 있죠.

2. 실시간 동기화(Real-time Sync):
GraphQL의 ‘구독(Subscription)’ 기능을 내장하고 있어서, 누군가 데이터를 변경하면 그 데이터를 보고 있는 모든 클라이언트 화면이 별도의 코드 없이 자동으로 업데이트됩니다. 예를 들어, A 사용자가 메모를 추가하면, 앱을 켜놓고 있던 B 사용자의 화면에도 즉시 새로운 메모가 나타나는 식이죠. (물론 권한 설정에 따라 다릅니다.)

DataStore를 사용하려면, 먼저 `amplify add api`를 할 때 충돌 감지(Conflict Detection) 설정을 켜야 합니다. 이미 API를 만들었다면 `amplify update api` 명령어로 설정을 변경할 수 있습니다.

DataStore를 사용하도록 코드를 바꾸는 것은 정말 간단합니다. 기존의 `API.graphql()` 호출 부분을 `DataStore`의 API로 바꾸기만 하면 됩니다.

// 기존 API 방식
// import { API } from 'aws-amplify';
// const apiData = await API.graphql({ query: listNotes });
// const notes = apiData.data.listNotes.items;

// DataStore 방식
import { DataStore } from 'aws-amplify';
import { Note } from './models'; // `amplify codegen models` 실행 시 생성됨

// 데이터 조회
const notes = await DataStore.query(Note);

// 데이터 생성
await DataStore.save(
  new Note({
    name: "새로운 메모",
    description: "내용입니다."
  })
);

// 데이터 삭제
await DataStore.delete(noteToDelete);

코드가 훨씬 더 직관적이고 간결해졌죠? 복잡한 GraphQL 쿼리 문자열을 다룰 필요 없이, 마치 로컬 데이터베이스를 다루는 것처럼 편하게 코드를 작성할 수 있습니다.

이처럼 DataStore는 사용자 경험을 한 차원 높여주는 강력한 기능이므로, 새로운 프로젝트를 시작한다면 `API` 카테고리 대신 DataStore를 우선적으로 고려해보는 것을 강력히 추천합니다.

Part 4. 스토리지(Storage): 이미지와 파일, 어디에 둘까? 📁

우리 메모장 앱에 이미지를 첨부하는 기능을 추가하고 싶다면 어떻게 해야 할까요? 이미지 파일을 데이터베이스에 직접 저장하는 것은 매우 비효율적입니다. 이럴 때 필요한 것이 바로 파일 저장소, 즉 스토리지입니다.

Amplify는 AWS의 대표적인 스토리지 서비스인 Amazon S3 (Simple Storage Service)를 아주 쉽게 연동할 수 있도록 도와줍니다.

amplify add storage

질문이 나타나면, `Content (Images, audio, video, etc.)`를 선택합니다. 그리고 접근 권한을 설정하게 되는데, 보통 다음과 같이 설정합니다.

  • Who should have access? `Auth and guest users` (인증한 사용자와 손님 모두)
  • What kind of access do you want for authenticated users? `create/update`, `read`, `delete` (로그인한 사용자는 업로드, 읽기, 삭제 가능)
  • What kind of access do you want for guest users? `read` (로그인 안 한 사용자는 읽기만 가능)

이렇게 설정하면, 로그인한 사용자는 파일을 올리고 지울 수 있지만, 비로그인 사용자는 보기만 가능한 S3 버킷이 생성됩니다.

설정이 끝났다면, 역시 `amplify push`로 클라우드에 반영해줍니다.

이제 프론트엔드 코드에서 파일을 업로드하고 다운로드하는 것은 식은 죽 먹기입니다.

import { Storage } from 'aws-amplify';

// 파일 업로드
async function handleFileChange(event) {
  const file = event.target.files[0];
  try {
    // Storage.put(파일이름, 파일객체, { level: 'private' | 'protected' | 'public' })
    // private: 나만 접근 가능
    // protected: 모든 로그인 유저가 읽을 수 있지만, 나만 수정/삭제 가능
    // public: 누구나 접근 가능
    await Storage.put(file.name, file, {
      level: 'private',
      contentType: file.type
    });
    console.log('성공적으로 업로드되었습니다!');
  } catch (error) {
    console.log('업로드 중 에러 발생: ', error);
  }
}

// 파일 URL 가져오기
async function getFileUrl(filename) {
  // private 파일은 기본적으로 만료 시간이 있는 임시 URL을 생성해줍니다.
  const url = await Storage.get(filename, { level: 'private' });
  return url;
}

`Storage.put()`으로 파일을 올리고, `Storage.get()`으로 파일의 URL을 받아와 `` 태그의 `src`에 넣어주기만 하면 됩니다. 파일 접근 수준(level)을 `private`으로 설정하면, Amplify가 알아서 해당 파일을 소유자만 접근할 수 있도록 S3 정책을 관리해줍니다. 정말 편리하죠?

Part 5. 호스팅(Hosting): 전 세계에 내 앱 자랑하기 🌐

자, 이제 로컬 컴퓨터에서 멋지게 작동하는 풀스택 앱이 완성되었습니다. 이제 이걸 친구들에게, 그리고 전 세계 사람들에게 보여줘야겠죠? 바로 ‘배포’의 시간입니다.

과거에는 배포를 위해 웹 서버(Nginx, Apache)를 설정하고, 빌드된 파일을 FTP로 올리고, 도메인을 연결하고, HTTPS 인증서(SSL)를 발급받는 등… 아주 복잡하고 머리 아픈 과정을 거쳐야 했습니다.

Amplify Hosting은 이 모든 과정을 Git과 연동하여 완벽하게 자동화해줍니다.

amplify add hosting

두 가지 선택지가 나옵니다.

  • Hosting with Amplify Console (Managed hosting with custom domains, CI/CD): Git 기반의 완전 자동 CI/CD 배포 방식입니다. (강력 추천!)
  • Amazon CloudFront and S3: 수동으로 파일을 업로드하는 방식입니다.

우리는 당연히 첫 번째, `Amplify Console`을 선택합니다. 그러면 배포 방식을 묻는데, `Continuous deployment (Git-based deployments)`를 선택합니다.

이 명령어를 실행하면 브라우저가 열리면서 Amplify Console 페이지로 이동합니다. 여기서 여러분의 코드가 있는 Git 저장소(GitHub, GitLab, Bitbucket 등)를 연결해주세요.

연결이 완료되면, 어떤 브랜치에 코드를 푸시(push)했을 때 배포를 실행할지 선택합니다. 예를 들어 `main` 브랜치를 선택하면, 앞으로 `main` 브랜치에 변경사항이 푸시될 때마다 Amplify가 자동으로 전체 빌드 및 배포 과정을 진행합니다.

🚀 CI/CD가 뭔가요?

CI/CD는 Continuous Integration(지속적 통합) / Continuous Deployment(지속적 배포)의 약자입니다. 개발자가 코드를 원격 저장소(Git)에 올리기만 하면, 나머지 테스트, 빌드, 배포 과정이 모두 자동으로 이루어지는 것을 의미합니다. 개발자는 오직 코드 작성에만 집중할 수 있게 되어 생산성이 극대화되죠. Amplify Hosting은 이 강력한 CI/CD 환경을 클릭 몇 번만으로 구축해줍니다.

모든 설정을 마치고 나면, Amplify가 첫 배포를 시작합니다. 프로비저닝(Provision), 빌드(Build), 배포(Deploy), 확인(Verify) 단계를 거쳐 몇 분 안에 배포가 완료되고, `https://main.xxxxxxxx.amplifyapp.com` 형태의 고유한 URL이 생성됩니다.

이 URL로 접속해보세요. 여러분이 만든 앱이 전 세계 어디서든 접속 가능한 실제 서비스로 탄생한 순간입니다! 🥳

Amplify Hosting의 진짜 무서운 점은 이게 끝이 아니라는 겁니다.

  • Feature Branch 배포: `feature/new-login` 같은 새로운 브랜치를 만들어 푸시하면, 해당 브랜치만의 고유한 URL로 앱이 자동 배포됩니다. 디자이너나 기획자에게 완성되기 전의 기능을 미리 보여주고 피드백 받기에 완벽하죠.
  • Pull Request 미리보기: GitHub에서 Pull Request를 생성하면, 변경사항이 적용된 앱을 미리 볼 수 있는 임시 환경을 자동으로 만들어줍니다. 코드를 머지하기 전에 시각적으로 리뷰할 수 있어 실수를 줄여줍니다.
  • 커스텀 도메인 및 HTTPS: `www.내서비스.com` 같은 개인 도메인을 연결하는 것도, 무료로 HTTPS(SSL) 인증서를 발급받아 적용하는 것도 콘솔에서 버튼 몇 번만 누르면 끝납니다.

이 모든 과정을 혼자서 구축하려면 며칠, 혹은 몇 주가 걸릴 수도 있는 일입니다. Amplify는 이 시간을 단 몇 분으로 단축시켜 줍니다.

CHAPTER 4: 더 높은 곳으로 - 고급 주제와 꿀팁 🍯

지금까지 Amplify의 핵심 기능들을 살펴보았습니다. 이것만으로도 웬만한 웹 서비스는 뚝딱 만들 수 있죠. 하지만 Amplify의 잠재력은 여기서 그치지 않습니다. 몇 가지 고급 주제와 실전 꿀팁을 알아두면 여러분의 개발 경험이 한층 더 풍부해질 거예요.

Functions (Lambda): 나만의 커스텀 로직 추가하기

Amplify가 자동으로 만들어주는 CRUD API만으로는 해결하기 어려운 복잡한 비즈니스 로직이 필요할 때가 있습니다. 예를 들어, 결제 API와 연동하거나, 이미지에 워터마크를 박거나, AI 모델을 호출하는 등의 작업이죠.

이럴 때 사용하는 것이 바로 AWS Lambda입니다. Lambda는 서버 없이 코드를 실행할 수 있는 서버리스 컴퓨팅 서비스로, Amplify에서는 `Function`이라는 이름으로 쉽게 추가할 수 있습니다.

amplify add function

이 명령어를 통해 Node.js, Python, Java 등 원하는 언어로 Lambda 함수를 만들고, 이 함수를 API Gateway와 연결하여 REST API 엔드포인트를 만들거나, AppSync의 리졸버로 연결하여 GraphQL API의 특정 필드를 처리하도록 할 수 있습니다.

예를 들어, `GET /payments` 라는 REST API를 만들고 싶다면, `amplify add api`를 실행해서 REST를 선택하고, 방금 만든 Lambda 함수와 연결해주기만 하면 됩니다. 이제 여러분은 Lambda 함수 코드 안에서 원하는 어떤 작업이든 자유롭게 구현할 수 있습니다.

Environments: 안전한 개발과 배포를 위한 필수 습관

혼자 개발하는 토이 프로젝트라면 괜찮지만, 여러 명의 팀원이 함께 작업하거나 실제 사용자가 있는 서비스를 운영할 때는 ‘환경(Environment)’을 분리하는 것이 매우 중요합니다.

- `dev` 환경: 개발자들이 자유롭게 기능을 추가하고 테스트하는 개발 환경. - `staging` 환경: 배포 직전의 최종 버전을 테스트하는 환경. 실제 운영 환경과 거의 동일하게 구성합니다. - `prod` (또는 `main`) 환경: 실제 사용자들이 사용하는 운영(프로덕션) 환경.

Amplify는 이 환경 관리를 아주 쉽게 만들어줍니다.

# 'staging'이라는 이름의 새로운 환경을 만듭니다.
# 현재 'dev' 환경의 모든 백엔드 설정을 그대로 복제해옵니다.
amplify env add

# 현재 내가 작업 중인 환경을 확인합니다.
amplify env list

# 'dev' 환경으로 다시 전환합니다.
amplify env checkout dev

이렇게 환경을 분리하면, `dev` 환경에서 API 스키마를 잘못 건드리는 등의 실수를 하더라도 실제 서비스(`prod` 환경)에는 아무런 영향을 주지 않아 안전합니다. 팀 개발의 필수 요소라고 할 수 있죠.

비용 관리: 내 지갑은 소중하니까

서버리스와 Amplify는 초기 비용이 거의 없고 사용한 만큼만 내기 때문에 매우 경제적이지만, ‘사용한 만큼’이라는 말은 반대로 사용량이 폭증하면 요금도 폭증할 수 있다는 뜻이기도 합니다.

AWS 콘솔의 ‘비용 탐색기(Cost Explorer)’와 ‘결제 대시보드(Billing Dashboard)’를 주기적으로 확인하는 습관을 들이는 것이 좋습니다. 어떤 서비스에서 비용이 많이 발생하는지 추적하고, 예산 알림(Budget Alert)을 설정해두면 특정 금액을 초과했을 때 이메일로 알림을 받을 수 있어 예상치 못한 요금 폭탄을 막을 수 있습니다.

특히 DynamoDB는 처리량(Provisioned Throughput)을 어떻게 설정하느냐에 따라 비용 차이가 크니, 트래픽 예측이 어렵다면 ‘온디맨드(On-Demand)’ 방식으로 설정하는 것이 초기에는 더 유리할 수 있습니다.

🚨 Amplify 프로젝트 삭제는 신중하게!

프로젝트를 더 이상 사용하지 않을 때는 로컬 폴더만 지우면 안 됩니다! 반드시 프로젝트 루트 폴더에서 `amplify delete` 명령어를 실행해야 합니다. 이 명령어를 실행해야 Amplify가 해당 프로젝트를 위해 생성했던 모든 AWS 리소스(Cognito, AppSync, DynamoDB, S3 등)를 깔끔하게 삭제해줍니다. 그렇지 않으면 사용하지도 않는 리소스에서 계속 요금이 발생할 수 있어요!

마치며: 이제 당신도 풀스택 개발자입니다!

여기까지 따라오시느라 정말 고생 많으셨습니다! 👏

우리는 서버리스의 개념부터 시작해서, AWS Amplify를 이용해 인증, API, 데이터베이스, 스토리지, 그리고 CI/CD가 완비된 호스팅까지, 하나의 완전한 풀스택 애플리케이션을 만들어내는 전체 여정을 함께했습니다.

과거에는 이 모든 것을 갖추기 위해 백엔드 개발자, 프론트엔드 개발자, 데브옵스(DevOps) 엔지니어가 한 팀을 이루어야 했지만, 이제 Amplify라는 강력한 도구 덕분에 아이디어를 가진 사람이라면 누구든, 심지어 혼자서도 이 모든 것을 해낼 수 있는 시대가 되었습니다.

물론 오늘 다룬 내용이 Amplify의 전부는 아닙니다. 분석(Analytics), 예측(Predictions), 푸시 알림(Push Notifications) 등 더 많은 기능들이 여러분의 탐험을 기다리고 있습니다. 하지만 오늘 배운 핵심 개념만 확실히 이해한다면, 나머지는 공식 문서를 참고하며 충분히 확장해나갈 수 있을 겁니다.

혹시 이 과정이 혼자서는 너무 벅차게 느껴지거나, 실제 비즈니스에 적용하기 위한 전문가의 도움이 필요하다면 재능넷과 같은 플랫폼에서 AWS 전문가나 숙련된 개발자에게 멘토링이나 외주 개발을 의뢰하는 것도 좋은 방법이 될 수 있습니다. 함께하면 더 멀리, 더 빨리 갈 수 있으니까요.

이제 서버와 인프라에 대한 두려움은 떨쳐버리세요.
여러분 머릿속에 잠자고 있던 멋진 아이디어를 꺼내, 세상에 보여줄 시간입니다.
AWS Amplify와 함께라면, 당신도 세상을 바꿀 앱을 만들 수 있습니다.

Happy Coding! 😊

댓글 작성

이 글에 대한 여러분의 생각을 들려주세요

댓글 0
댓글을 불러오는 중입니다.

아직 댓글이 없습니다.