からのpythonコードの生成 OpenAPI

API Agent OpenAPI 仕様から コードを生成し、生成されたコードを にデプロイし、デプロイ後に アプリケーション を反映するようにソース ドキュメントを更新するのに役立ちます。 Python IBM Code Engine Code Engine URL OpenAPI

このタスクについて

API Agent を使って、 Python FastAPI サーバー・コードを OpenAPI 仕様 3.0 に基づいて生成する。 Python FastAPI サーバー・コードの生成方法の詳細については、 OpenAPI Python Generator toolを参照のこと。

以下のステップでは、データベースCRUDサーバーのサーバーコードを作成する方法を、1つのシナリオフロー例として示します。

手順

Python コードを生成するには、以下の手順を実行する:

  1. ログイン API Agent. 詳しくは「 はじめに 」をご覧ください。
  2. 以下のプロンプトを入力し、[ 送信] をクリックする:
    Generate some Python FastAPI server with database interaction code based on the following openapi @
    をクリックし、必要なファイルを選択します。例えば、 order_apispec.yaml
    注: プロンプトの後に@を入力すると、ワークスペースで利用可能な OpenAPI 文書のリストが表示されます。
  3. 送信をクリックする。 OpenAPI Python Generatorツールは API Agentソースと通信し、提案されたプランを表示する。
  4. Startをクリックしてコード生成を開始する。 完了すると、生成されたコードをダウンロードするために必要な次のステップと、それを実行してデプロイする方法の簡単な要約を見ることができます。
  5. ダウンロードアイコンをクリックして、コードを含むZIPファイルを保存してください。
  6. Visual Studio Code で、ターミナルを開き、以下のコマンドを実行して、ダウンロードしたファイルをフォルダ、例えば app-code に解凍する。
    unzip PostgreSQL-order-python.zip
  7. README.md ファイルを開いて、ダウンロードしたコードの使用方法をご覧ください。 README.md には、アプリケーションのビルド、インストール、カスタマイズ、デプロイ方法に関する詳細情報が記載されています。
  8. 以下のプロンプトを入力して、生成されたフォルダのzipを展開します(認証情報が入力されていることを確認してください):
    zip -r code.zip app_code/
    注: ファイルサイズは 1MB 以下でなければなりません。 コードを圧縮してデプロイする前に、 venv/ フォルダーを削除してください。
  9. 次の行動が提案された:
    Deploy the application code from code.zip
    注: 次に予定されているアクションが、生成された Python FastAPI サーバーアプリケーションを、 Code デプロイメントツールを 使用して IBM Code Engine にデプロイするものである場合、デプロイメント後に、アプリケーションが生成されたソース OpenAPI ドキュメントが更新され、 Code Engine アプリケーション URL が servers[0].url の値として反映されていることを確認してください。 このステップは、その後に予定されているアクションがドラフトAPIを作成し、 API Connect Task ツールを使用して API Connect。 詳細については、 コード展開のステータスのセクションを参照してください。