이 튜토리얼에서는 플라스크 웹 프레임워크에 기반한 작은 Python 애플리케이션으로 작업합니다. 다음 섹션에서는 컴퓨터에서 이 애플리케이션을 설정하고 실행하는 데 도움이 되는 지침을 제공합니다. 이 섹션을 완료하려면 운영 체제의 터미널 또는 명령 프롬프트 창에서 작업해야 합니다.
스타터 애플리케이션 다운로드
아래 링크를 클릭하여 스타터 검색 애플리케이션을 다운로드하세요.
문서 디렉토리와 같이 프로젝트에 적합한 상위 디렉터리를 찾아 그곳에서 zip 파일의 내용을 압축 해제합니다. 그러면 여러 하위 디렉터리와 파일이 있는 검색 튜토리얼 디렉터리가 추가됩니다.
Python 종속성 설치
터미널에서 이전 섹션에서 만든 검색 튜토리얼 디렉토리로 변경합니다.
이제 파이썬 모범 사례에 따라 이 프로젝트 전용의 비공개 파이썬 환경인 가상 환경을 만들겠습니다. 다음 명령으로 이 작업을 수행합니다:
이 명령은 .venv에 파이썬 가상 환경을 생성합니다. (dot-venv) 디렉터리로 이동합니다. 이 명령에서 .venv 을 원하는 이름으로 바꿀 수 있습니다. 일부 파이썬 설치에서는 python3 대신 python 을 사용하여 파이썬 인터프리터를 호출해야 할 수도 있습니다.
다음 단계는 가상 환경을 활성화하는 것으로, 이 가상 환경을 현재 터미널 세션의 활성 파이썬 환경으로 만드는 방법입니다. Linux 또는 macOS와 같은 UNIX 기반 운영 체제에서 작업하는 경우 다음과 같이 가상 환경을 활성화합니다:
위의 활성화 명령은 Microsoft Windows 컴퓨터의 WSL 환경 내에서 작업하는 경우에도 작동합니다. 그러나 Windows 명령 프롬프트 또는 PowerShell을 사용하는 경우에는 활성화 명령이 다릅니다:
가상 환경이 활성화되면 명령줄 프롬프트가 환경의 이름을 표시하도록 변경됩니다:
참고: 이전에 가상 환경을 사용해 본 적이 없다면 활성화 명령은 영구적인 것이 아니며 명령이 입력된 터미널 세션에만 적용된다는 점에 유의해야 합니다. 두 번째 터미널 창을 열거나 전날 컴퓨터를 끈 후 다시 돌아와서 이 튜토리얼을 계속 진행하려면 활성화 명령을 반복해야 합니다.
Python 환경을 구성하는 마지막 단계는 스타터 애플리케이션에 필요한 몇 가지 패키지를 설치하는 것입니다. 이전 단계에서 가상 환경이 활성화되었는지 확인한 다음 다음 명령을 실행하여 이러한 종속성을 설치합니다:
애플리케이션 실행
이 시점에서 다음 명령어로 애플리케이션을 시작할 수 있어야 합니다:
애플리케이션이 실행 중인지 확인하려면 브라우저를 열고 http://localhost:5001 으로 이동합니다.
참고: 이 초기 단계의 애플리케이션은 빈 껍데기일 뿐입니다. 검색창에 원하는 내용을 입력하고 검색을 요청할 수 있지만 항상 결과가 없다는 답변이 돌아옵니다. 다음 섹션에서는 Elasticsearch 인덱스에서 일부 콘텐츠를 로드하고 검색을 수행하는 방법에 대해 알아보세요.
플라스크 애플리케이션은 개발 모드에서 실행되도록 구성되어 있습니다. 소스 파일이 변경된 것을 감지하면 자동으로 다시 시작하여 변경 사항을 반영합니다. 튜토리얼을 계속 진행하는 동안 애플리케이션을 실행한 상태로 이 터미널 세션을 그대로 둘 수 있으며, 변경을 수행하면 애플리케이션이 다시 시작되어 업데이트됩니다.