1. ホームページ
  2. Service Mesh
  3. Service Mesh の設定
  4. コマンドラインインターフェースの使用

  5. API の更新

CLI を使用した API の更新

API は常に変化するため、Anypoint Service Mesh では同じメジャーバージョン内で API の仕様を更新できるようにしています (マイナーおよびパッチバンプのみが許可されています)。API は Anypoint Platform または Anypoint Service Mesh を使用して更新できます。

  • Anypoint Service Mesh を使用して API を更新する​

    API リソースがクラスター内に存在する場合は、リソースを更新することで、アセットバージョンや API インスタンスの作成や変更などを Anypoint Platform でトリガーできます。

  • Anypoint Platform を使用して API を更新する​

    新しいバージョンの API を Anypoint Exchange (Exchange) にパブリッシュしたら、新しいアセットバージョンを使用するように、アセットに関連付けられている API インスタンスを更新できます。

    アセットタグは Exchange から、API インスタンスタグは API Manager で更新できます。

Anypoint Service Mesh コマンドラインインターフェースを使用して API を更新する

Anypoint Service Mesh の Autocreate 機能を使用して API を設定した場合は、必要に応じてクラスターから API を更新できます。更新時には、API のプロビジョニングで使用した環境の詳細とログイン情報が再利用されます。

API を更新するには、次の手順を実行します。

  1. Anypoint Service Mesh CLI から次のコマンドを実行します。

    asmctl api update
--name=_Kubernetes API resource name_ \
--namespace=_namespace name_ \
--version=_(Optional) new asset version for the API_ \
--mainFile=_(Optional) name of the main file in the API specification_ \
--specPath=_(Optional) path to the API specification file_ \
--specTags=_(Optional) list of comma separated tags to be added to the asset on Exchange_ \
--instanceTags=_(Optional) list of comma separated tags to be added to the instance on API Manager_
    text
    パラメーター名 説明 必須または省略可能 デフォルト値

    ​name

    既存の Kubernetes API リソース名 (例: orders-api​)

    必須

    適用なし

    ​namespace

    API を作成した名前空間 (例: mulesoft-apps​)

    必須

    適用なし

    ​version

    メジャー、マイナー、およびパッチリリースのセマンティックバージョン設定の形式での Exchange の新しいアセットのバージョン

    省略可能

    適用なし

    ​mainFile

    API 仕様ファイルのメインファイル名。YAML または JSON ファイルには仕様ファイルと同じ名前を付け、ZIP ファイルを使用する場合はメインファイル名とプライマリファイル名が一致する必要があります。

    ​version​ 項目を使用する場合は、​oas​、​raml​、または ​wsdl​ API では必須

    適用なし

    ​specPath

    API 仕様ファイルへの相対または絶対パス

    ​version​ 項目を使用する場合は、​oas​、​raml​、または ​wsdl​ API では必須

    適用なし

    ​specTags

    Exchange のアセットに追加するタグ

    省略可能

    適用なし

    ​instanceTags

    API Manager の API インスタンスに追加するタグ

    省略可能

    適用なし

  2. API が正常に更新されていることを確認します。 ​asmctl api list​

  3. 必要に応じて、Exchange でアセットが変更され、API Manager で API インスタンスが変更されたことを確認します。

Anypoint Platform を使用した API の更新

Anypoint Platform から API を更新する場合は、Exchange でアセットを更新するか、または API Manager で API インスタンスを更新できます。

Exchange で API アセットを更新する

Anypoint Platform を使用して既存のアセットを更新するか、または新しいバージョンを作成するには、次の手順を実行します。

  1. [Anypoint Platform]​ > ​[Exchange]​ に移動して、変更するアセットを選択します。

  2. 変更する内容により、次のいずれかのアクションを実行します。

    1. 新しいバージョンをアップロードする場合は、右側のテーブルで ​[Add new version (新規バージョンを追加)]​ をクリックします。

    2. バージョンのタグを変更する場合は、右側のパネルで ​[Tags (タグ)]​ をクリックします。

API Manager で API インスタンスを更新する

既存の API インスタンスを更新するには、次の手順を実行します。

  1. [Anypoint Platform]​ > ​[API Manager]​ に移動します。

  2. 結果テーブルで自分の API インスタンスを探します。

  3. [API Configuration (API 設定)]​ セクションで、自分の API インスタンスのタグを更新します。

  4. API バージョンを更新します。

    アセット更新の表示、60%

関連情報