Kongは拡張可能なオープンソースAPIレイヤー(APIゲートウェイやAPIミドルウェアとも呼ばれる)です。 Kongは任意のRESTful API上で動作し、プラグインで拡張し、コアプラットフォームを超えた追加機能やサービスを提供します。
KongはもともとMashapeで構築され、APIマーケットプレイス向けに15,000以上のAPIとマイクロサービスを提供し、20万人以上の開発者向けに毎月数十億件のリクエストを生成しました。 現在、コングは小規模から大規模の組織までミッションクリティカルな展開で使用されています
最新バージョンは0.14.1です
公式ウェブサイト:ハイパーリンクのログインが見えます。
GitHub:ハイパーリンクのログインが見えます。
Kongプラグイン紹介アドレス:ハイパーリンクのログインが見えます。
コング関連文書住所:ハイパーリンクのログインが見えます。
コングはコミュニティ版およびエンタープライズ版、その二つの差は以下の通りです:ハイパーリンクのログインが見えます。
KongはPostgreSQL 9.5+およびCassandra 3.xxをデータストアとしてサポートしています。
私はPostgreSQLをインストールしており、チュートリアルは以下の通りです:
この記事では、Kong Community Editionを例として導入・展開しています
ダウンロードパッケージ:
設置:
バージョンを確認してください
又は
プロフィール作成:
もしあなたの設定がすべての値はコメントアウトされています、Kongはデフォルト設定で動作します。 起動時に、Kongは設定ファイルを含む可能性のあるいくつかのデフォルトロケーションを探します。
/etc/kong/kong.conf
/etc/kong.conf
kong_defaults.lua
nginx.lua
nginx_kong.lua
データベースの初期化
始める
データベースを初期化してKongを起動する際に、[-c /path/to/kong.conf]パラメータで設定ファイルを指定できます。
Kongが起動した後、1つは8000、もう1つは8001で、80000ポートはリクエストエントリポートとなり、ユーザーはまずKongプロジェクトの8000ポートにリクエストを送信し、Kongは設定されたルールに従って実際のバックグラウンドサービスアドレスに転送します。 8001ポートは管理ポートであり、プラグイン設定、API追加、削除、修正、負荷分散などの一連の構成が8001ポートを通じて管理されます。
ブラウザアクセスIP:8000、以下の返事をします:
{"メッセージ":「その値でルートもAPIも見つかりません」}
Kong管理者管理インターフェース(外部ネットワークがアクセスできない場合は、バインディング設定を変更してパブリックネットワークアクセスを許可できます）
{"plugins":{"enabled_in_cluster":[],"available_on_server":{"response-transformer":true,"oauth2":true,"acl":true,"correlation-id":true,"pre-function":true,"jwt":true," cors":true,"ip-restriction":true,"basic-auth":true,"key-auth":true,"rate-limiting":true,"request-transformer":true,"http-log":true,"file-log":true,"hmac-auth":true," ldap-auth":true,"datadog":true,"tcp-log":true,"zipkin":true,"post-function":true,"request-size-limiting":true,"bot-detection":true,"syslog":true,"loggly":true," azure-functions":true,"udp-log":true,"response-ratelimiting":true,"aws-lambda":true,"statsd":true,"prometheus":true,"request-termination":true}},"tagline":"Welcome to kong","configuration":{"plugins":["bundled"],"admin_ssl_enabled":true,"lua_ssl_verify_depth":1,"trusted_ips":{},"prefix":"\/usr\/local\/kong","loaded_plugins":{" response-transformer":true,"request-termination":true,"prometheus":true,"ip-restriction":true,"pre-function":true,"jwt":true,"cors":true,"statsd":true,"basic-auth": true,"key-auth":true,"ldap-auth":true,"aws-lambda":true,"HTTP-Log":true,"response-ratelimiting":true,"hmac-auth":true,"request-size-limiting":true,"datadog":true," TCP-log":true,"zipkin":true,"post-function":true,"bot-detection":true,"acl":true,"loggly":true,"syslog":true,"azure-functions":true,"udp-log":true,"file-log":true," request-transformer":true,"correlation-id":true,"rate-limiting":true,"oAuth2":true},"cassandra_username":"kong","admin_ssl_cert_csr_default":"\/usr\/local\/kong\/ssl\/ admin-kong-default.csr","ssl_cert_key":"\/usr\/local\/kong\/ssl\/kong-default.key","admin_ssl_cert_key":"\/usr\/local\/kong\/ssl\/admin-kong-default.key","dns_ resolver":{},"pg_user":"kong","mem_cache_size":"128m","cassandra_data_centers":["dc1:2","dc2:3"],"nginx_admin_directives":{},"custom_plugins":{},"pg_host":"127.0.0.1" ,"nginx_acc_logs":"\/usr\/local\/kong\/logs\/access.log","proxy_listen":["0.0.0.0:8000","0.0.0.0:8443 SSL"],"client_ssl_cert_default":"\/usr\/local\/kong\/ssl\/ kong-default.crt","ssl_cert_key_default":"\/USR\/local\/kong\/ssl\/kong-default.key","dns_no_sync":false,"db_update_propagation":0,"nginx_err_logs":"\/usr\/local\/ kong\/logs\/error.log","cassandra_port":9042,"dns_order":["LAST","SRV","A","CNAME"],"dns_error_ttl":1,"headers":["server_tokens","latency_tokens"],"dns_stale_ttl":4," nginx_optimizations":true,"database":postgres","pg_database":"kong","nginx_worker_processes":"auto","lua_package_cpath":"","admin_acc_logs":"\/usr\/local\/kong\/logs\/ admin_access.log","lua_package_path":".\/?. lua;.\/?\/init.lua; ","nginx_pid":"\/usr\/local\/kong\/pids\/nginx.pid","upstream_keepalive":60,"cassandra_contact_points":["127.0.0.1"],"admin_access_log":"logs\/admin_access.log"," client_ssl_cert_csr_default":"\/usr\/local\/kong\/ssl\/kong-default.csr","proxy_listeners":[{"ssl":false,"ip":"0.0.0.0","proxy_protocol":false,"port":8000,"http2": false,"listener":"0.0.0.0:8000"},{"ssl":true,"ip":"0.0.0","proxy_protocol":false,"port":8443,"http2":false,"listener":"0.0.0.0:8443 ssl"}],"proxy_ssl_enabled":true," pg_password":"******","cassandra_ssl":false,"enabled_headers":{"latency_tokens":true,"X-Kong-Proxy-Latency":true,"Via":true,"server_tokens":true,"Server":true," X-Kong-Upstream-Latency":true,"X-Kong-Upstream-Status":false},"ssl_cert_csr_default":"\/usr\/local\/kong\/ssl\/kong-default.csr","client_ssl":false,"db_resurrect_ttl" :30,"error_default_type":"text\/plain","cassandra_consistency":"ONE","client_max_body_size":"0","admin_error_log":"logs\/error.log","pg_ssl_verify":false,"dns_not_ found_ttl":30,"pg_ssl":false,"db_update_frequency":5,"ssl_ciphers":"ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305: ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES128-SHA256: ECDHE-RSA-AES128-SHA256","cassandra_repl_strategy":"SimpleStrategy","cassandra_repl_factor":1,"log_level":"notice","admin_ssl_cert":"\/usr\/local\/kong\/ssl\/ admin-kong-default.crt","real_ip_header":"X-Real-IP","kong_env":"\/usr\/local\/kong\/.kong_env","cassandra_schema_consensus_timeout":10000,"dns_hostsfile":"\/etc\/ hosts","admin_listeners":[{"ssl":false,"ip":"127.0.0.1","proxy_protocol":false,"port":8001,"http2":false,"listener":"127.0.0.1:8001"},{"ssl":true,"ip":"127.0.0.1"," proxy_protocol":false,"port":8444,"http2":false,"listener":"127.0.0.1:8444 ssl"}],"cassandra_timeout":5000,"ssl_cert":"\/usr\/local\/kong\/ssl\/kong-default.crt"," proxy_access_log":"logs\/access.log","admin_ssl_cert_key_default":"\/usr\/local\/kong\/ssl\/admin-kong-default.key","cassandra_ssl_verify":false,"ssl_cipher_suite":" modern","cassandra_lb_policy":"RoundRobin","real_ip_recursive":"off","proxy_error_log":logs\/error.log","client_ssl_cert_key_default":"\/usr\/local\/kong\/ssl\/ kong-default.key","nginx_daemon":"on","anonymous_reports":true,"db_cache_ttl":0,"nginx_proxy_directives":{},"pg_port":5432,"nginx_kong_conf":"\/usr\/local\/kong\/ nginx-kong.conf","client_body_buffer_size":"8k","lua_socket_pool_size":30,"admin_ssl_cert_default":"\/usr\/local\/kong\/ssl\/admin-kong-default.crt","nginx_http_ directives":[{"value":"prometheus_metrics 5m","name":"lua_shared_dict"}],"cassandra_keyspace":"kong","ssl_cert_default":"\/usr\/local\/kong\/ssl\/kong-default.crt"," nginx_conf":"\/usr\/local\/kong\/nginx.conf","admin_listen":["127.0.0.1:8001","127.0.0.1:8444 ssl"]},"version":"0.14.1","node_id":"2388666-845c-450b-9e9d-4b74b5267eb9","lua_version":"LuaJIT 2.1.0-beta3","prng_seeds":{"pid: 30380":521312001726},"timers":{"pending":5,"running":0},"hostname":"VM_0_9_centos"}
グローバルパラメータ
つまり、すべてのコマンドは以下のパラメータで追加できます
--ヘルプヘルプコマンド
--v 詳細モードをオンに
--vv でデバッグモードをオンにします
コマンドライン
コングチェック
kong.confの有効性を確認してください
使用法:コングチェック [コンプレックス]
[コンプ] (デフォルトで/etc/kong.confまたは/etc/kong/kong.confをチェックします)
コング、準備
Kongのプリフォルダやサブフォルダ、ファイルを準備してください---正直なところ、このコマンドが何のためか分かりません。そもそも使ったことがありません
コング・ヘルス
コングノードの健康状態を確認してください
コングの移動
Kongデータベースの管理
参考文献:
Kong設定ドキュメント:https://docs.konghq.com/0.14.x/configuration/
コングCLIコマンド:https://docs.konghq.com/0.14.x/cli/
|
掲載地 2018/11/21 13:33:04
|
|
|
|
地主|
掲載地 2018/11/30 15:36:55
|
掲載地 2023/05/16 11:15:21