このチュートリアルでは、Flask Web フレームワークに基づく小さな Python アプリケーションを操作します。次のセクションでは、このアプリケーションをコンピューターにセットアップして実行するための手順を説明します。このセクションを完了するには、オペレーティング システムのターミナルまたはコマンド プロンプト ウィンドウで作業する必要があります。
スターターアプリケーションをダウンロードする
以下のリンクをクリックして、スターター検索アプリケーションをダウンロードしてください。
プロジェクトに適した親ディレクトリ (ドキュメントディレクトリなど) を見つけて、そこに zip ファイルの内容を抽出します。これにより、内部にいくつかのサブディレクトリとファイルを含むsearch-tutorialディレクトリが追加されます。
Pythonの依存関係をインストールする
ターミナルから、前のセクションで作成したsearch-tutorialディレクトリに変更します。
Python のベスト プラクティスに従って、このプロジェクト専用のプライベート Python 環境である仮想環境を作成します。次のコマンドでこれを実行します。
このコマンドは.venvファイルにPython仮想環境を作成します。(dot-venv) ディレクトリ。このコマンドの.venv任意の名前に置き換えることができます。Python の一部のインストールでは、Python インタープリターを呼び出すためにpython3ではなくpythonを使用する必要があることに注意してください。
次のステップは、仮想環境をアクティブ化することです。これは、この仮想環境を、現在使用しているターミナル セッションのアクティブな Python 環境にする方法です。Linux や macOS などの UNIX ベースのオペレーティング システムで作業している場合は、次のように仮想環境をアクティブ化します。
上記のアクティベーション コマンドは、Microsoft Windows コンピューターの WSL 環境内で作業している場合にも機能します。ただし、Windows コマンド プロンプトまたは PowerShell を使用している場合は、アクティベーション コマンドが異なります。
仮想環境がアクティブになると、コマンドラインプロンプトが変更され、環境の名前が表示されます。
注: これまで仮想環境を使用したことがない場合は、アクティベーション コマンドは永続的ではなく、コマンドが入力されたターミナル セッションにのみ適用されることに注意してください。2 番目のターミナル ウィンドウを開いた場合、または前日にコンピューターをオフにした後にこのチュートリアルの作業を続行する場合、アクティベーション コマンドを繰り返す必要があります。
Python 環境を構成する最後の手順は、スターター アプリケーションに必要ないくつかのパッケージをインストールすることです。前の手順で仮想環境がアクティブ化されたことを確認してから、次のコマンドを実行してこれらの依存関係をインストールします。
アプリケーションを実行する
この時点で、次のコマンドでアプリケーションを起動できるはずです。
アプリケーションが実行中であることを確認するには、ブラウザを開いてhttp://localhost:5001に移動します。
注: この初期段階のアプリケーションは単なる空のシェルです。必要に応じて検索ボックスに何かを入力して検索を要求することもできますが、常に結果がないという応答が返されます。次のセクションでは、Elasticsearch インデックスにコンテンツをロードして検索を実行する方法を学習します。
Flask アプリケーションは開発モードで実行するように構成されています。ソース ファイルが変更されたことを検出すると、変更を組み込むために自動的に再起動します。チュートリアルを続行する間、アプリケーションを実行したままこのターミナル セッションを終了できます。変更を加えると、アプリケーションが再起動して更新されます。