旧バージョンのドキュメントを参照しています。 最新のドキュメントはこちらをご参照ください。
Kong Managerでのエディタの使用
Kong Managerは、ブラウザ内からDev Portalのテンプレートファイルを編集するための強力なファイルエディターを提供します。
前提条件
- Kong Managerへのアクセス
- Kong Dev Portalが 有効 かつ 実行中
注: エディタモードは、Dev Portal を レガシー モードで実行している場合は使用 できません 。
編集モードに入る
ワークスペース の Kong Manager ダッシュボードから、サイドバーの Dev Portal の下にある Editor をクリックします。
これで 編集モード が起動します。
エディターの操作
有効にすると、Dev PortalにKongのデフォルトのテーマが事前に入力されます。ファイルエディターはこれらのファイルをUIに公開し、ブラウザー内からすばやく簡単に編集できるようにします。エディターを初めて開くと、左側にファイルのリストと空白の編集フォームが表示されます。
-
New File+
をクリックして、エディターから直接 Dev Portal の新しいファイルを作成します。 - コンテンツ/仕様/テーマごとに区切られた、Dev Portalで公開されているすべてのテンプレートファイルのリスト。
- Code View - サイドバーからファイルを選択すると、ここにコードが表示されます。
- Portal Preview - 選択したDev Portalファイルのライブプレビューが表示されます。
- 表示の切り替え - フルスクリーンコード、分割ビュー、フルスクリーンプレビューモードの 3 つのビューから選択します。
ファイルの編集
サイドバーからファイルを選択して編集用に開きます。これにより、ファイルがコードビューに表示され、ポータルプレビューにライブアップデートが表示されます。右上隅の [保存] をクリックすると、更新がデータベースに保存され、Dev Portalのファイルが更新されます。
新しいファイルの追加
New File +
ボタンをクリックすると、新規ファイルのダイアログが開きます。
作成されたファイルは、すぐにエディター内から利用できるようになります。
ファイルの認証
認証はコンテンツページのreadable_by
値によって処理されます(GUIビューの場合は、権限ページに移動してください)
- readable_by
設定: ‘*’ を古い認証済みと等しく設定してください
- 特定のロールへのアクセスを制限するには、readable_by
を許可されたロールの配列に設定します(最初に権限ページでロールを作成する必要があります)
- 仕様上、readable_by
は “x-headmatter
” オブジェクト内に設定されています
ファイルの削除
エディター内からファイルを 完全に 削除するには、ファイル名を右クリックし、ポップアップメニューから 削除 を選択します。