Jump To Close Expand all Collapse all Table of contents 3scale の操作 1. 3scale の操作とスケーリングのガイド Expand section "1. 3scale の操作とスケーリングのガイド" Collapse section "1. 3scale の操作とスケーリングのガイド" 1.1. はじめに Expand section "1.1. はじめに" Collapse section "1.1. はじめに" 1.1.1. 前提条件 1.1.2. 関連資料 1.2. APIcast の再デプロイ 1.3. オンプレミス型 3scale のスケールアップ Expand section "1.3. オンプレミス型 3scale のスケールアップ" Collapse section "1.3. オンプレミス型 3scale のスケールアップ" 1.3.1. ストレージのスケールアップ Expand section "1.3.1. ストレージのスケールアップ" Collapse section "1.3.1. ストレージのスケールアップ" 1.3.1.1. 方法 1: 永続ボリュームをバックアップしてスワップする 1.3.1.2. 方法 2: 3scale をバックアップして再デプロイする 1.3.2. パフォーマンスのスケールアップ Expand section "1.3.2. パフォーマンスのスケールアップ" Collapse section "1.3.2. パフォーマンスのスケールアップ" 1.3.2.1. オンプレミス型 3scale デプロイメントの設定 1.3.2.2. ハードウェアの垂直スケーリングと水平スケーリング 1.3.2.3. ルーターのスケールアップ 1.4. 操作のトラブルシューティング Expand section "1.4. 操作のトラブルシューティング" Collapse section "1.4. 操作のトラブルシューティング" 1.4.1. OpenShift での 3scale 監査ロギングの設定 Expand section "1.4.1. OpenShift での 3scale 監査ロギングの設定" Collapse section "1.4.1. OpenShift での 3scale 監査ロギングの設定" 1.4.1.1. 監査ロギングの有効化 1.4.1.2. EFK ロギングの設定 1.4.2. ログへのアクセス 1.4.3. ジョブキューの確認 1.4.4. 単調増加の防止 2. 3scale toolbox の使用 Expand section "2. 3scale toolbox の使用" Collapse section "2. 3scale toolbox の使用" 2.1. toolbox のインストール Expand section "2.1. toolbox のインストール" Collapse section "2.1. toolbox のインストール" 2.1.1. RHEL へのツールボックスのインストール 2.1.2. toolbox コンテナーイメージのインストール 2.1.3. サポートされないバージョンの toolbox のインストール 2.2. サポートされる toolbox コマンドの使用 2.3. サービスのインポート 2.4. サービスのコピー 2.5. サービス設定のみのコピー 2.6. OpenAPI 定義のインポート Expand section "2.6. OpenAPI 定義のインポート" Collapse section "2.6. OpenAPI 定義のインポート" 2.6.1. オプションのフラグ 2.7. リモートアクセスクレデンシャルの管理 Expand section "2.7. リモートアクセスクレデンシャルの管理" Collapse section "2.7. リモートアクセスクレデンシャルの管理" 2.7.1. リモートアクセスクレデンシャルの一覧表示 2.7.2. リモートアクセスクレデンシャルの追加 2.7.3. リモートアクセスクレデンシャルの削除 2.7.4. リモートアクセスクレデンシャルの名前変更 2.8. アプリケーションプラン Expand section "2.8. アプリケーションプラン" Collapse section "2.8. アプリケーションプラン" 2.8.1. 新しいアプリケーションプランの作成 2.8.2. アプリケーションプランの作成または更新 2.8.3. アプリケーションプランの一覧表示 2.8.4. アプリケーションプランの表示 2.8.5. アプリケーションプランの削除 2.8.6. アプリケーションプランのエクスポート/インポート Expand section "2.8.6. アプリケーションプランのエクスポート/インポート" Collapse section "2.8.6. アプリケーションプランのエクスポート/インポート" 2.8.6.1. ファイルへのアプリケーションプランのエクスポート 2.8.6.2. ファイルからのアプリケーションプランのインポート 2.8.6.3. URL からのアプリケーションプランのインポート 2.9. メトリック Expand section "2.9. メトリック" Collapse section "2.9. メトリック" 2.9.1. メトリクスの作成 2.9.2. メトリクスの作成または更新 2.9.3. メトリクスの一覧表示 2.9.4. メトリクスの削除 2.10. メソッド Expand section "2.10. メソッド" Collapse section "2.10. メソッド" 2.10.1. メソッドの作成 2.10.2. メソッドの作成または更新 2.10.3. メソッドの一覧表示 2.10.4. メソッドの削除 2.11. サービスの作成 Expand section "2.11. サービスの作成" Collapse section "2.11. サービスの作成" 2.11.1. 新しいサービスの作成 2.11.2. サービスの作成または更新 2.11.3. サービスの一覧表示 2.11.4. サービスの表示 2.11.5. サービスの削除 2.12. ActiveDocs Expand section "2.12. ActiveDocs" Collapse section "2.12. ActiveDocs" 2.12.1. 新しい ActiveDocs の作成 2.12.2. ActiveDocs の作成または更新 2.12.3. ActiveDocs の一覧表示 2.12.4. ActiveDocs の削除 2.13. プロキシー設定 Expand section "2.13. プロキシー設定" Collapse section "2.13. プロキシー設定" 2.13.1. プロキシー設定の一覧表示 2.13.2. プロキシー設定の表示 2.13.3. プロキシー設定のプロモート 2.14. ポリシーレジストリー (カスタムポリシー) のコピー 2.15. アプリケーション Expand section "2.15. アプリケーション" Collapse section "2.15. アプリケーション" 2.15.1. アプリケーションの一覧表示 2.15.2. アプリケーションの作成 2.15.3. アプリケーションの表示 2.15.4. アプリケーションの作成または更新 2.15.5. アプリケーションの削除 2.16. SSL の問題のトラブルシューティング 3. Automating API lifecycle with 3scale toolbox Expand section "3. Automating API lifecycle with 3scale toolbox" Collapse section "3. Automating API lifecycle with 3scale toolbox" 3.1. API ライフサイクルステージの概要 Expand section "3.1. API ライフサイクルステージの概要" Collapse section "3.1. API ライフサイクルステージの概要" 3.1.1. API プロバイダーサイクル 3.1.2. API 利用者サイクル 3.2. サンプル Jenkins CI/CD パイプラインのデプロイ Expand section "3.2. サンプル Jenkins CI/CD パイプラインのデプロイ" Collapse section "3.2. サンプル Jenkins CI/CD パイプラインのデプロイ" 3.2.1. サンプル Jenkins CI/CD パイプライン 3.2.2. ホスト型 3scale 環境の設定 3.2.3. オンプレミス型 3scale 環境の設定 3.2.4. OpenID Connect 向け Red Hat Single Sign-On のデプロイ 3.2.5. 3scale toolbox のインストールおよびアクセスの有効化 3.2.6. API バックエンドのデプロイ 3.2.7. Self-managed APIcast インスタンスのデプロイ 3.2.8. サンプルパイプラインのインストールとデプロイ 3.2.9. 3scale toolbox を使用した API ライフサイクル自動化の制約 3.3. 3scale Jenkins 共有ライブラリーを使用したパイプラインの作成 3.4. Jenkinsfile を使用したパイプラインの作成 4. 3scale での API 環境のマッピング Expand section "4. 3scale での API 環境のマッピング" Collapse section "4. 3scale での API 環境のマッピング" 4.1. 環境ごとのサービス 4.2. オンプレミス型 3scale インスタンス Expand section "4.2. オンプレミス型 3scale インスタンス" Collapse section "4.2. オンプレミス型 3scale インスタンス" 4.2.1. 環境ごとの 3scale インスタンスの分離 4.2.2. 環境ごとの 3scale テナントの分離 4.3. 混合アプローチ 4.4. APIcast ゲートウェイ Expand section "4.4. APIcast ゲートウェイ" Collapse section "4.4. APIcast ゲートウェイ" 4.4.1. APIcast の組み込みデフォルトゲートウェイ 4.4.2. 追加の APIcast ゲートウェイ 5. 機能: operator を使用した 3scale のサービスおよび設定のプロビジョニング Expand section "5. 機能: operator を使用した 3scale のサービスおよび設定のプロビジョニング" Collapse section "5. 機能: operator を使用した 3scale のサービスおよび設定のプロビジョニング" 5.1. 前提条件 5.2. capabilities に関連するカスタムリソースのデプロイ Expand section "5.2. capabilities に関連するカスタムリソースのデプロイ" Collapse section "5.2. capabilities に関連するカスタムリソースのデプロイ" 5.2.1. API の作成 5.2.2. プランの追加 5.2.3. メトリクスの追加 5.2.4. 制限の設定 5.2.5. マッピングルールの追加 5.2.6. バインディングの作成 5.3. オプションテナントカスタムリソースのデプロイ 5.4. 作成したカスタムリソースの削除 6. 3scale のバックアップと復元 Expand section "6. 3scale のバックアップと復元" Collapse section "6. 3scale のバックアップと復元" 6.1. 前提条件 6.2. 永続ボリューム 6.3. 留意事項 6.4. データセットの使用 Expand section "6.4. データセットの使用" Collapse section "6.4. データセットの使用" 6.4.1. system-mysql の定義 6.4.2. system-storage の定義 6.4.3. zync-database の定義 6.4.4. backend-redis の定義 6.4.5. system-redis の定義 6.5. バックアップの手順 Expand section "6.5. バックアップの手順" Collapse section "6.5. バックアップの手順" 6.5.1. system-mysql のバックアップ 6.5.2. system-storage のバックアップ 6.5.3. zync-database のバックアップ 6.5.4. backend-redis のバックアップ 6.5.5. system-redis のバックアップ 6.6. データベースの復元手順 Expand section "6.6. データベースの復元手順" Collapse section "6.6. データベースの復元手順" 6.6.1. system-mysql の復元 6.6.2. system-storage の復元 6.6.3. zync-database の復元 6.6.4. バックエンド と システム 間の情報の一貫性確保 Expand section "6.6.4. バックエンド と システム 間の情報の一貫性確保" Collapse section "6.6.4. バックエンド と システム 間の情報の一貫性確保" 6.6.4.1. backend-redis のデプロイメント設定の管理 6.6.4.2. system-redis のデプロイメント設定の管理 7. トラブルシューティング Expand section "7. トラブルシューティング" Collapse section "7. トラブルシューティング" 7.1. 典型的な問題 Expand section "7.1. 典型的な問題" Collapse section "7.1. 典型的な問題" 7.1.1. インテグレーションの問題 Expand section "7.1.1. インテグレーションの問題" Collapse section "7.1.1. インテグレーションの問題" 7.1.1.1. Hosted APIcast 7.1.1.2. Self-managed APIcast 7.1.2. 実稼働環境の問題 Expand section "7.1.2. 実稼働環境の問題" Collapse section "7.1.2. 実稼働環境の問題" 7.1.2.1. 可用性の問題 7.1.3. デプロイ後の問題 7.2. トラブルシューティングの基本 Expand section "7.2. トラブルシューティングの基本" Collapse section "7.2. トラブルシューティングの基本" 7.2.1. 1. 接続の可否を確かめる 7.2.2. 2.問題の発生場所を特定する 7.2.3. 3. DNS に問題がないか調べる 7.2.4. 4. SSL に問題がないか調べる 7.3. トラブルシューティングのチェックリスト Expand section "7.3. トラブルシューティングのチェックリスト" Collapse section "7.3. トラブルシューティングのチェックリスト" 7.3.1. API 7.3.2. API ゲートウェイ > API 7.3.3. API ゲートウェイ Expand section "7.3.3. API ゲートウェイ" Collapse section "7.3.3. API ゲートウェイ" 7.3.3.1. 1. API ゲートウェイが起動して稼働しているか調べる 7.3.3.2. 2. ゲートウェイログでエラーの有無を確認する 7.3.4. API ゲートウェイ > 3scale Expand section "7.3.4. API ゲートウェイ > 3scale" Collapse section "7.3.4. API ゲートウェイ > 3scale" 7.3.4.1. 1. API ゲートウェイが 3scale にアクセスできるか調べる 7.3.4.2. 2.API ゲートウェイが 3scale のアドレスを正しく解決しているか調べる 7.3.4.3. 3. API ゲートウェイが 3scale を正しく呼び出していることの確認 7.3.5. 3scale Expand section "7.3.5. 3scale" Collapse section "7.3.5. 3scale" 7.3.5.1. 1. 3scale が利用可能か確かめる 7.3.5.2. 2. 3scale がエラーを返しているか調べる 7.3.5.3. 3. 3scale デバッグヘッダーを使用する 7.3.5.4. 4.インテグレーションエラーを確認する 7.3.6. クライアント API ゲートウェイ Expand section "7.3.6. クライアント API ゲートウェイ" Collapse section "7.3.6. クライアント API ゲートウェイ" 7.3.6.1. 1. 一般のインターネットから API ゲートウェイにアクセスできるか調べる 7.3.6.2. 2. クライアントから API ゲートウェイにアクセスできるか調べる 7.3.7. クライアント Expand section "7.3.7. クライアント" Collapse section "7.3.7. クライアント" 7.3.7.1. 1. 別のクライアントを使用して同じ呼び出しをテストする 7.3.7.2. 2. クライアントから送信されたトラフィックを確認する 7.4. その他の問題 Expand section "7.4. その他の問題" Collapse section "7.4. その他の問題" 7.4.1. ActiveDocs の問題 Expand section "7.4.1. ActiveDocs の問題" Collapse section "7.4.1. ActiveDocs の問題" 7.4.1.1. 1. petstore.swagger.io を使用する 7.4.1.2. 2. ファイアウォールが ActiveDocs プロキシーからの接続を許可していることを確認する 7.4.1.3. 3. 無効なクレデンシャルを使用して API を呼び出す 7.4.1.4. 4. 呼び出しを比較する 7.5. 付録 Expand section "7.5. 付録" Collapse section "7.5. 付録" 7.5.1. NGINX でのロギング Expand section "7.5.1. NGINX でのロギング" Collapse section "7.5.1. NGINX でのロギング" 7.5.1.1. デバッグログの有効化 7.5.2. 3scale のエラーコード Settings Close Language: 日本語 English Language: 日本語 English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Language and Page Formatting Options Language: 日本語 English Language: 日本語 English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF 6.5.2. system-storage のバックアップ system-storage ファイルを別のストレージにアーカイブします。 oc rsync $(oc get pods -l 'deploymentConfig=system-app' -o json | jq '.items[0].metadata.name' -r):/opt/system/public/system ./local/dir Previous Next