外部リポジトリからStyleBookをインポートして同期する

最終公開日 : Oct 02, 2026
開発にCI/CDプロセスを使用しているシナリオ、またはすべてのアプリケーションソースコードとデプロイメントアーティファクトをGitHub/GitLabで管理しているシナリオを考えてみましょう。
GitHub/GitLabリポジトリでは、NetScaler構成をデプロイし、これらのStyleBookを管理するために、いくつかのStyleBookを保守している場合があります。これらのStyleBookをNetScaler Consoleにアップロードする必要があります。この機能を使用すると、GitHub/GitLabにあるStyleBookをNetScaler Consoleに直接インポートできます。GitHub/GitLabから手動でコピーしてNetScaler Consoleにアップロードしたり、NetScaler ConsoleとGitHub/GitLabの両方でファイルを手動で同期したりする必要はありません。また、GitHub/GitLabから構成パックをインポートして同期することもできます。
StyleBookと構成パックをインポートするには、NetScaler ConsoleでGitHub/GitLabリポジトリを表すリポジトリを定義します。GitHub/GitLabリポジトリのURLと、GitHub/GitLabで作成したユーザー名およびAPIまたは個人アクセストークン（PAトークン）を指定します。つまり、GitHub/GitLabで有効なアカウントを持つ承認されたユーザーのみがStyleBookをインポートおよび同期できます。
次の種類のリポジトリをインポートおよび同期できます。
  • 公開アクセス可能なリポジトリ - 一般に公開されており、インターネット経由でアクセスできるリポジトリ。
  • オンプレミスまたはプライベートなGitLab/GitHubリポジトリ - プライベートにホストされており、通常は企業のイントラネット内でのみアクセスできるリポジトリ。これらのリポジトリの場合、登録プロセス中にNetScalerエージェントを選択する必要があります。NetScalerエージェントは、企業のイントラネット内のリポジトリにアクセスするためのプロキシとして機能します。
リポジトリを作成した後、NetScaler ConsoleをGitHub/GitLabリポジトリと同期できます。NetScaler ConsoleはGitHub/GitLabに接続し、そのリポジトリで見つかったStyleBookと構成パックをインポートします。その後、NetScaler ConsoleはStyleBookを検証し、NetScaler ConsoleのStyleBookリストに追加します。検証に失敗したStyleBookはNetScaler Consoleに追加されません。StyleBookのエラーを特定して修正できます。その後、更新されたバージョンをGitHub/GitLabリポジトリにコミットします。後で、それらをNetScaler Consoleに再度インポートまたは同期を試すことができます。
リポジトリの作成中に次のエラーが発生した場合、それは、NetScaler Consoleが、不足しているまたは認識されていない認証局（CA）証明書のために、リポジトリのSSL証明書を検証できないことを示しています。
certificate verify failed: unable to get local issuer certificate
この問題を解決するには、リポジトリへのアクセスに使用されるNetScaler Consoleエージェントに、必要なCA証明書を手動で追加できます。必要なCA証明書を追加することで、外部リポジトリへの安全な接続が適切に検証されるようになります。
リポジトリへのアクセスに使用されるNetScaler Consoleエージェントにログインし、CA証明書を信頼された証明書バンドル/var/mps/ca_certs/cacert.pemに追加します。
重要
  • StyleBookファイルは、GitHub/GitLabリポジトリの任意のブランチからインポートおよび同期できます。
  • 依存するStyleBookが関連付けられているStyleBookもインポートおよび同期できます。これらの依存StyleBookは、GitHub/GitLabリポジトリにあるか、すでにNetScaler Consoleに存在している可能性があります。
  • GitHub/GitLabリポジトリからのStyleBookの同期は、NetScaler Consoleの管理画面またはAPIから手動で開始する必要があります。つまり、現在、StyleBookの取り込みと同期は、GitHub/GitLabのコミットアクティビティに基づいて自動的に行われるわけではありません。
  • インポートする構成パックファイルはJSON形式である必要があります。また、構成ファイルの内容はエクスポートされた構成形式に従う必要があります。GitHub/GitLabリポジトリでは、構成パックに関連付けられたファイルはconfigpacksフォルダーにある必要があります。
GitHub/GitLabリポジトリの任意のフォルダーからNetScaler ConsoleにStyleBookファイルをインポートできます。構成パックをインポートするには、次の手順を実行します。
  1. ルートディレクトリの下にconfigpacksという名前のフォルダーを作成します。構成に関連するすべてのファイルがこのフォルダーにあることを確認してください。
  2. configpacksフォルダーに、構成パックのペイロードを含むJSONファイルを作成します。このペイロードは、構成パックを同期するために使用されます。以下はペイロードの例です。
    {
        "config_key": "unique-key-for-configpack",

        "parameters": {
            "param-name1": "param-value1",
            "param-name": "param-value2",
            "param-namen": "param-valuen"
        },
        "stylebook": {
            "namespace": "some namespace",
            "name": "somename",
            "version": "spme-version"
        }
    }
    • config_key - NetScaler Consoleで構成パックを識別するための一意のIDまたは名前。config_keyを指定しない場合、NetScaler Consoleは構成パックの作成時にIDを自動生成します。
      指定されたIDがNetScaler Console GUIで見つかった場合、同期アクションはNetScaler Console GUIの構成パックを更新します。それ以外の場合は、指定されたIDで構成パックを作成します。
    • parameters - 構成パックを作成または更新するために必要なすべてのパラメーターが含まれています。
    • stylebook - JSONファイル内の必須プロパティです。構成パックを関連付けたい名前空間、バージョン、およびStyleBook名が含まれています。
  3. configpacksフォルダーには、証明書、署名ファイル、XMLファイルなど、構成パックに関連するすべてのファイルを保持します。
Related information
StyleBooks

リポジトリを追加

  1. NetScaler Consoleで、Applications > Configuration > Repositories に移動します。Add をクリックします。
  2. Add Repository ウィンドウで、次のパラメーターを入力します。
    • 名前 - リポジトリの名前を入力します。この名前は、GitHub/GitLabのリポジトリ名と同じでも、異なるものでも構いません。
    • リポジトリURL - GitHub/GitLabリポジトリのURLを入力します。
      GitHub/GitLabエンタープライズURLを指定できます。これにより、GitHub/GitLabエンタープライズアカウントからStyleBookとconfig packをインポートまたは同期できます。
    • プライベートURLですか？ - リポジトリがオンプレミスまたはプライベートのGitLab/GitHubリポジトリである場合は、このチェックボックスをオンにしてから、エージェントを選択します。
    • ユーザー名 - GitHub/GitLabアカウントまたはエンタープライズアカウントへのアクセスに使用するユーザー名を入力します。
    • API/PAトークン - このトークンは、GitHub/GitLabリポジトリにアクセスするために使用されます。GitHub/GitLabリポジトリのAPI/PAトークンの作成方法については、個人アクセストークンの作成に関するGitHub/GitLabドキュメントを参照してください。
    GitHubリポジトリを追加(/en-us/netscaler-console-service/media/stylebooks-git-import-1.png)
    GitLabリポジトリを追加(/en-us/netscaler-console-service/media/stylebooks-gitlab-import.png)
  3. 作成をクリックします。
    リポジトリがNetScaler Consoleに作成されます。

リポジトリオプション

リポジトリの追加オプションは次のとおりです。
  • 編集 - リポジトリのURL、ユーザー名、APIトークンを編集できます。
  • 削除 - そのGitHub/GitLabリポジトリから以前にインポートされた、NetScaler Consoleに存在するすべてのStyleBookとともにリポジトリを削除できます。
    注
    関連付けられたconfig packを持つStyleBookがある場合、NetScaler Consoleからリポジトリを削除することはできません。まず、これらのStyleBookのすべてのconfig packを削除します。その後、NetScaler Consoleからリポジトリを削除して、そのリポジトリからStyleBookをクリーンアップできます。
  • リセット - リポジトリエントリを実際に削除することなく、そのリポジトリから同期されたNetScaler Console内のすべてのStyleBookを削除できます。
  • ファイルの一覧表示 - GitHub/GitLabリポジトリから取得された、NetScaler Consoleに存在するすべてのStyleBookのリストを表示できます。

GitHub/GitLabからStyleBookと設定パックをインポートする手順

前提条件を完了したら、GitHub/GitLabリポジトリからStyleBookと設定パックをインポートする手順に従ってください。
  1. オプション：まだ追加していない場合は、リポジトリを追加します。
  2. リポジトリページでリポジトリを選択します。
  3. 同期をクリックします。