Konnect サービスカタログ

アーキテクチャ全体のあらゆるサービスを追跡

この機能はbetaとしてリリースされており、本番環境では依存すべきではありません。

Kong KonnectのService Catalogは、組織で実行されているすべてのサービスの包括的なカタログを提供します。Gateway ManagerやMesh ManagerのようなKonnect内部アプリケーションと、GitHubやPagerDutyのような外部アプリケーションの両方と統合することで、Service Catalogは組織の各サービスを360度見渡すことができます。サービスの所有者、上流と下流の依存関係、コード・リポジトリ、CI/CDパイプライン、APIゲートウェイによってフロントされているか、サービス・メッシュの一部であるかなどの情報が表示される。

 
graph LR
  %% Define styles for icons and nodes
  classDef konnect stroke-dasharray:3,rx:10,ry:10
  classDef serviceCatalog fill:#d0e5f3,rx:10,ry:10
  %% Define the resources
  ExternalIntegration1(External Integration 1):::resource
  ExternalIntegration2(External Integration 2</div>):::resource
  GatewayManager(
 Gateway Manager):::resource

  %% Define the Konnect Service Catalog and its subgraphs
  subgraph KonnectServiceCatalog[Konnect Service Catalog]
    direction TB

    %% Define the Billing Service subgraph inside Konnect Service Catalog
    subgraph BillingService[Billing Service]
      direction LR
      KongGatewayService(Gateway service 1)
      ExternalResourceMapping1(External resource)
      ExternalResourceMapping2(External resource)
    end

    %% Define the Inventory Service Catalog Service subgraph inside Konnect Service Catalog
    subgraph InventoryService[Inventory Service]
      direction LR
      SomeOtherService(Gateway service 2)
      AnotherService(External resource)
      DifferentRepo(External resource)
    end

  end

  %% Connect the resources to the Konnect Service Catalog
  ExternalIntegration1 -- "External resource" --> KonnectServiceCatalog
  ExternalIntegration2 -- "External resource" --> KonnectServiceCatalog
  GatewayManager -- "Gateway services" --> KonnectServiceCatalog

  %% Style the subgraphs
  class KonnectServiceCatalog konnect
  class BillingService serviceCatalog
  class InventoryService serviceCatalog

Figure 1: This diagram shows how you can use both external integrations, like GitHub and PagerDuty, as well as internal integrations like Gateway Manager to pull resources into Service Catalog. You can then map those resources (like GitHub repositories, PagerDuty services, and Gateway services) to Service Catalog services.

Service Catalog use cases

あなたが望むのは…	そうしたいなら…
チームをService Catalogサービスにマッピングすることで、組織のリソース所有権を追跡できます。	KonnectにService Catalogサービスを新規作成](https://cloud.konghq.com/service-catalog/create-service)する際に、Service Catalogサービスの所有者を追加します。
組織内の未認識または未発見のAPIを含む、すべてのサービスを可視化します。	Service Catalog 統合
主要なService Catalogサービスの健全性メトリクス、ドキュメント、およびAPI仕様を1つのリストに統合し、1つの場所から他のツールとやり取りできるようにします。	Service Catalogダッシュボード

Service Catalog 用語

用語	定義
インテグレーション	これらはKonnect内部または外部のアプリケーションで、リソースを取り込むソースとして機能します。例えば、GitHub。
リソース	有効化された統合からService Catalogが取り込むエンティティを示す包括的な用語。リソースには、インフラストラクチャー・コンポーネント（ゲートウェイ・サービス、メッシュ・サービス、データベース、キャッシュなど）から、外部アプリケーションやツール（コード・リポジトリ、CI/CDインフラストラクチャー、オンコール・システムなど）、ドキュメントの一部（API仕様など）まで、さまざまなものがある。リソースは1つ以上のService Catalogサービスにマップすることができます。
Service Catalog service	通常1つのチームが所有し、1つ以上のAPIを公開し、他のService Catalogサービスに（上流または下流として）依存する可能性があるソフトウェアの単位。サービスは、1つ以上のリソースのコレクションと考えることができます。
Service Catalog	組織で実行されているすべてのリソースとService Catalogサービスの総合カタログ。
イベント	イベントはService Catalogによって記録される情報の捕捉単位です。ユーザー主導のアクション、設定変更、アラートなど、幅広いアクティビティが含まれる。

FAQs

サービスカタログのサービスはAPI製品とどのように対応するのか？そこでの関係は？

Service CatalogサービスはAPI製品に直接マッピングされません。むしろ、GatewayサービスをService Catalogサービスにリンクして、GatewayサービスをService CatalogのAPI製品バージョンにマッピングすることができます。

サービスカタログで自分のサービスのヘルスとステータスを表示するにはどうすればよいですか？

サービスカタログのサービスに移動し、ヘルスとステータスを表示したいサービスカタログサービスをクリックします。

Service Catalogサービスにマッピング可能なリソースを特定するにはどうすればよいですか？

サービスカタログのリソースページに移動して、利用可能なすべてのリソースのリストを表示します。これらのリソースは、Integrationsページにある、インストールされ認証された統合からService Catalogに取り込まれます。

サービスカタログに表示されるデータに不一致がある場合はどうすればよいですか？

Service Catalogの統合設定とデータソースに問題がないか確認する。接続されているすべてのツールが適切に設定され、データの同期が正しく機能していることを確認します。

特定のService Catalogサービスやデータへのアクセス権を管理できますか？

はい、teamsとrolesを設定することで、アクセス制御を設定し、サービスカタログの権限を管理できます。

More information

Service Catalog integrations