프로젝트 소개

AWS Amplify CLI(Gen 1)는 서버리스 웹 및 모바일 애플리케이션 개발을 간소화하기 위한 명령줄 도구 체인입니다. AWS CloudFormation과 중첩 스택을 사용하므로 개발자는 로컬에서 구성을 추가하거나 수정한 뒤 AWS 계정에서 실행되도록 푸시할 수 있습니다. README에 따르면 Amplify Gen 1은 유지보수 모드이며, 2026년 5월 1일부터 Gen 1 백엔드는 중요한 버그 수정과 보안 패치만 제공되고 2027년 5월 1일에 지원이 종료됩니다. 신규 프로젝트는 Amplify Gen 2를 사용하도록 안내되며, 기존 Gen 1 사용자는 제공된 마이그레이션 가이드와 도구를 사용해 이전하는 것이 권장됩니다. 설치에는 Node.js 버전 22 이상이 필요합니다. CLI는 npm을 통해 @aws-amplify/cli로 전역 설치되며, 이후 amplify configure를 실행해 AWS 액세스 자격 증명, 리전 및 새 AWS 사용자 프로필을 설정합니다. 핵심 명령은 다음과 같습니다. amplify configure는 자격 증명과 프로필 설정을 담당합니다. amplify init은 프로젝트를 초기화하고 배포 리소스를 준비합니다. amplify configure project는 init 설정을 업데이트합니다. amplify add와 amplify update는 범주별로 클라우드 기능을 추가하거나 수정합니다. amplify push는 로컬 변경 사항을 바탕으로 클라우드 리소스를 프로비저닝하며, no-gql-override 플래그는 주석이 달린 GraphQL 스키마의 자동 컴파일을 건너뛰고 로컬 AppSync 리졸버와 템플릿을 재정의합니다. amplify pull은 업스트림 백엔드 환경 변경 사항을 가져옵니다. amplify publish는 호스팅이 활성화된 경우 push를 실행하고 정적 자산을 Amazon S3 및 Amazon CloudFront에 게시합니다. amplify status는 cloudformation-diff를 사용해 로컬 리소스와 배포된 리소스 간의 상세 차이를 보여주는 verbose 모드를 포함합니다. amplify serve는 push를 실행하고 프로젝트 시작 명령을 실행합니다. amplify delete는 프로젝트 리소스를 제거합니다. amplify help는 핵심 CLI 도움말을 제공합니다. amplify codegen add 또는 generate는 GraphQL 스키마에서 강력한 타입의 객체를 생성합니다. amplify env add, list, remove, get, pull, import, checkout은 다중 환경 워크플로를 지원합니다. 범주별 명령은 auth(Amazon Cognito), storage(Amazon S3 및 Amazon DynamoDB), function(AWS Lambda), api(AWS AppSync 및 Amazon API Gateway), analytics(Amazon Pinpoint), hosting(Amazon S3 및 Amazon CloudFront 배포), notifications(Amazon Pinpoint), interactions(Amazon Lex), predictions(Amazon Rekognition, Amazon Textract, Amazon Translate, Amazon Polly, Amazon Transcribe, Amazon Comprehend 및 Amazon SageMaker)를 다룹니다. README에서 연결되는 튜토리얼에는 시작 가이드, GraphQL transform 튜토리얼, Amplify CLI 및 AWS AppSync를 사용한 네이티브 개발이 포함됩니다. 개발을 위해 기여자는 로컬 환경을 설정하고, amplify-dev init 및 범주 하위 명령과 함께 amplify-dev를 사용해 범주를 테스트할 수 있으며, 코드를 푸시하거나 풀 리퀘스트를 열기 전에 최상위 수준에서 yarn lint를 실행하고, 오류가 있는 패키지에서는 yarn lint-fix를 사용한 뒤 남은 lint 문제를 수동으로 해결해야 합니다. 기여 지침은 저장소에 제공됩니다.