서버리스 FastAPI 개발: AWS에서 Player FC API 구축

오랜만에 간단하고 흥미롭고 현대적인 것을 만들 기회가 생겼습니다. 2024년 백엔드가 되자 우연히 FastAPI를 발견하고 기뻤습니다. 이전에 직장에서 내부 API를 구축했지만 아직 공개적으로 공개되는 API를 만든 적이 없었습니다.

안녕하세요 FastAPI!

FastAPI는 Python으로 API를 구축하기 위한 현대적이고 강력한 프레임워크이며 제가 구축하고 싶었던 기본 축구 선수 정보용 API에 완벽해 보였습니다. "Player FC API"로 정착하기 전에 처음에는 "Jugador FC"라고 불렀습니다.

환경 구성.

시작하기 전에 다음 요구 사항이 충족되었는지 확인하세요.

AWS CDK
도커
파이썬 3.12.7

프로젝트 만들기

컴퓨터에 디렉터리를 만듭니다. 이름을 player_fc_fastapi_app으로 지정하고 이 디렉터리 내에 다음 하위 디렉터리를 만듭니다.

앱
    모든 FastAPI 코드가 포함되어 있습니다
dynamo_db_local
    Amazon DynamoDB 테이블의 로컬 버전을 생성하기 위한 Python 스크립트가 포함되어 있습니다
악
    AWS에서 리소스를 생성하기 위한 스택 파일이 포함되어 있습니다

아래에서 시간을 절약하기 위해 실행할 수 있는 명령을 제공하여 작업을 더 쉽게 만들었습니다.

이제 프로젝트 디렉토리 구조는 다음과 같습니다.

Python 환경 설정

디렉터리 구조를 생성한 후 요구사항.txt라는 텍스트 파일을 생성하고 여기에 다음 줄을 삽입합니다.

requirements.txt 파일을 생성한 후 가상 환경을 생성하고 종속성을 설치합니다.

Amazon DynamoDB 로컬 설정

DynamoDB의 로컬 인스턴스 설정부터 시작하겠습니다. 이를 위해서는

Docker

를 설치하고 실행해야 합니다.

이미지를 가져오고 컨테이너를 시작하는 데 몇 초가 걸립니다. 완료되면

dynamo_db_local 디렉터리로 이동하여 create_ddb_table.py 파일을 생성하고 아래 코드로 파일을 채울 수 있습니다. :

이 코드를 사용하면 로컬 DynamoDB 인스턴스에 테이블을 생성할 수 있습니다. 코드 스니펫을 실행하세요. FastAPI 개발

이제

DynamoDB

의 로컬 인스턴스가 실행되었으므로 앱 생성을 시작하고

app

디렉터리로 이동하여 main.py와 요구 사항이라는 두 개의 파일을 생성해 보겠습니다. txt.

requirements.txt를 아래 내용으로 채웁니다.

아래 하위 디렉터리를 만듭니다.

모델

     Pydantic 선수 모델<script></script> <script></script>라우터<script></script><script></script>      경로 포함<script></script> <script></script> <script></script> <script></script>

Pydantic을 사용하여 몇 가지 모델을 만들어 보겠습니다. Player 및 UpdatePlayer 모델을 사용하여 추가하거나 수정할 수 있는 플레이어 정보의 데이터 구조를 정의하겠습니다.

models 하위 디렉터리 내에 빈 __init__.py 파일과 player.py라는 파일을 만들고 아래 코드로 채웁니다.

routers

하위 디렉터리 내에 빈 __init__.py 파일과 player.py라는 파일을 만들고 아래 코드로 채웁니다.

빈 __init__.py 파일을 생성하면 폴더가 Python 패키지로 전환됩니다.

app

하위 디렉터리에 main.py라는 파일을 만들고 아래 코드로 채우기 시작합니다.

테스트 드라이브 빠른 테스트 드라이브 시간입니다. app

디렉터리에 있는지 확인하고 아래 명령을 실행하여

Uvicorn

을 시작하세요.

이제 앱이 실행되었으므로

http://127.0.0.1:8000/docs/

로 이동하세요.

사용 가능한 6개의 엔드포인트가 포함된 자동 대화형 API 문서가 표시됩니다.

플레이어를 추가해 보겠습니다.

POST /players

엔드포인트를 선택하고

사용해 보기

버튼을 선택한 후 아래 페이로드를 사용하여 세계 최고의 플레이어인 "Vinícius Júnior"를 추가하세요.

각 API 작업의 실제 모습은 다음과 같습니다.

새 플레이어 추가:

모든 플레이어 검색:

플레이어 정보 업데이트:

싱글 플레이어 세부정보 가져오기:

플레이어 제거:

AWS CDK v2를 사용한 배포

이제 로컬에서 앱을 실행하고 테스트하는 데 익숙해졌으므로 AWS에 앱을 배포할 차례입니다. AWS CDK v2를 사용하겠습니다.

<script></script>iac<script></script> 디렉터리로 이동하고 아래 명령을 실행하여 CDK 프로젝트를 초기화합니다.<script></script> <script></script> <script></script> <script></script>

하위 디렉터리에 있는 requirements.txt 파일을 수정하고 아래 줄을 추가하세요.

DynamoDB 테이블, Lambda 함수 및 Lambda 함수 URL을 정의해 보겠습니다. 현재 iac 디렉터리에는 탐색해야 하는 또 다른 하위 디렉터리(iac

)가 있습니다. iac_stack.py 파일을 열고 CDK 스택의 내용을 아래 코드로 바꿉니다.

배포를 시작하기 전에 마지막 단계가 하나 있습니다. app/routers 디렉토리에 있는 player.py 파일에서 local_development: bool에 대한 플래그를

False

로 설정하는 것입니다.

iac

디렉터리 내에서 가상 환경을 활성화하고 아래 명령을 사용하여 종속성을 설치합니다.

cdk 배포 명령을 사용하여 앱을 배포합니다.
배포가 완료되면 터미널 출력에 함수 URL이 표시됩니다. 이것이 AWS의 API 엔드포인트입니다.

로컬 테스트 기간 동안 했던 것처럼 함수 URL을 사용하여 모든 엔드포인트를 테스트하세요. 플레이어를 추가한 후에는 플레이어 데이터가 지속되거나 에테르 속으로 사라졌는지 확인할 차례입니다.
1. 모든 것이 제대로 작동하는지 확인하려면:
2. AWS Management Console으로 이동하세요.
3. DynamoDB로 이동합니다.
4. 플레이어 테이블 찾기

테이블 항목 탐색

선택

클라우드에서 플레이어 데이터를 볼 수 있습니다.

?

중요: 리소스를 정리하는 것을 잊지 마세요! 더 이상 필요하지 않으면 cdk destroy 명령을 실행하여 생성된 모든 AWS 리소스를 삭제할 수 있습니다. <script></script>로컬 FastAPI 개발부터 AWS의 서버리스 배포까지의 여정이 끝났습니다.<script></script> <script></script> <script></script>

위 내용은 서버리스 FastAPI 개발: AWS에서 Player FC API 구축의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!