前回、Apache Spark と InterSystems Data Platform を使って機械学習を実験するためのプレイグラウンドを作成したときは（「Spark と Caché による機械学習」を参照）、Caché、Python、Apache Spark、Java、Hadoop ライブラリなど、すべてを直接自分のノートパソコンにインストールして構成しました。 これには多少の努力が必要でしたが、最終的には上手くいきました。 満足していましたが、 心配になりました。 「この手順をすべて再現できるのだろうか？」 ―多分できる。 「Windows や Java のアップデートですべてが一瞬にして台無しになる可能性はないか？」 ―ほぼ確実にある。

今では、ますます普及しているコンテナとますます使いやすくなった Docker for Windows により、事前に構成された機械学習環境とデータサイエンス環境を選択できるようになりました。 たとえば、Jupyter Docker Stacks と Zeppelin on Docker Hub をご覧ください。

重要である理由

IAMの管理を手動で行うには手間ががかります。OpenAPI（Swagger）仕様を使用して、APIがすでにしっかりとドキュメント化されている場合はなおさらです。 Open API仕様から直接、Kongサービスやルートを自動生成できたらいいのにと思いませんか？

このObjectScriptメソッドはまさにその処理を行います。仕様クラスの XData ブロック内に保管されているOpenAPI 2.0仕様を読み取り、IAM構成を同期するために使用できるdecKと互換性があるYAMLファイルを生成します。

このアプローチは：

• 手動による構成エラーを削減します
• ゲートウェイをAPI仕様に常に同期します
• デプロイメントとオンボーディングを高速化します

前提条件：

• InterSystems IRIS、またはIRISベースのプラットフォーム
• InterSystems API Manager
• Deck CLIツール

メソッドの内容

メソッド ConvertOpenAPIXDataToDeckYAML の機能は次のとおりです。

1. OpenAPI仕様を読み取る： 指定したクラス内の OpenAPI という名前の XData ブロックから読み取ります。

2. JSONを解析する：動的オブジェクトに変換します。

3. エンドポイントを抽出する ：HTTPメソッドも抽出します。