外部リポジトリからStyleBookをインポートして同期する
開発にCI/CDプロセスを使用しているシナリオ、またはすべてのアプリケーションソースコードとデプロイオブジェクトをGitHub/GitLabで管理しているシナリオを検討してください。
GitHub/GitLabリポジトリでは、NetScaler構成をデプロイし、これらのStyleBookを管理するためにいくつかのStyleBookを作成している場合があります。これらのStyleBookはNetScaler Consoleでも必要です。これで、これらのStyleBookをNetScaler Consoleに直接インポートできます。GitHub/GitLabから手動でコピーしてNetScaler Consoleにアップロードしたり、NetScaler ConsoleとGitHub/GitLabの両方でファイルを手動で同期したりする必要はありません。
StyleBookと構成パックをインポートするには、GitHub/GitLabリポジトリを表すリポジトリをNetScaler Consoleで定義します。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に追加されません。エラーを修正し、更新されたバージョンをGitHub/GitLabリポジトリにコミットしてください。後で、それらをNetScaler Consoleに再度インポートまたは同期を試すことができます。
注
-
StyleBookファイルは、GitHub/GitLabリポジトリの任意のブランチからインポートおよび同期できます。
-
依存するStyleBookが関連付けられているStyleBookもインポートおよび同期できます。
-
The synchronization of StyleBooks from a GitHub/GitLab repository must be initiated manually from the NetScaler Console GUI or API. That is, currently, importing and syncing of StyleBooks does not happen automatically based on GitHub/GitLab commit activity.
リポジトリを追加し、外部リポジトリからStyleBookをインポートする
開始する前に、GitHub/GitLabで有効なアカウントを持っていることを確認してください。
GitHub/GitLabリポジトリ内の任意のフォルダーからNetScaler ConsoleにStyleBookファイルをインポートできます。
-
NetScaler Consoleで、Applications > StyleBooks > Repositories に移動します。
-
Add をクリックします。Add Repository ウィンドウで、次のパラメータを入力します。
-
名前。リポジトリの名前を入力します。この名前は、GitHub/GitLabのリポジトリ名と同じでも、異なるものでも構いません。
-
リポジトリURL - GitHub/GitLabリポジトリのURLを入力します。GitHub/GitLabエンタープライズURLを指定できます。これにより、GitHub/GitLabエンタープライズアカウントからStyleBookと設定パックをインポートまたは同期できます。
-
プライベートURLですか？ - リポジトリがオンプレミスまたはプライベートのGitLab/GitHubリポジトリである場合は、このチェックボックスを選択し、Agent を選択します。
-
ユーザー名とパスワード。GitHub/GitLabアカウントにアクセスするためのユーザー名とパスワードを入力します。
注パスワードの代わりにAPIトークンを指定することもできます。APIトークンは、HTTPS経由でGitHub/GitLabのパスワードの代わりに使用できます。GitHub/GitLabリポジトリのAPI/PAトークンの作成方法については、個人アクセストークンの作成に関するGitHub/GitLabのドキュメントを参照してください。 -
-
Create をクリックします。
リポジトリがNetScaler Consoleに作成されます。 -
StyleBookをインポートまたは同期するには、Repositories ページでリポジトリを選択し、Sync をクリックします。
ここで使用できるその他のアクションは次のとおりです。
-
編集。リポジトリのURL、ユーザー名、パスワード（またはAPIトークン）を編集できます。
-
削除。NetScaler Consoleに存在する、以前そのGitHub/GitLabリポジトリからインポートされたすべてのStyleBookとともに、リポジトリを削除できます。注関連付けられたConfigPackを持つStyleBookが存在する場合、NetScaler Consoleからリポジトリを削除することはできません。まず、これらのStyleBookのすべてのConfigPackを削除してください。その後、NetScaler Consoleからリポジトリを削除して、そのリポジトリからStyleBookをクリーンアップできます。
-
リセット。NetScaler Consoleからリポジトリのエントリを実際に削除することなく、そのリポジトリから同期されたNetScaler Console内のすべてのStyleBookを削除できます。
-
ファイルの一覧表示。GitHub/GitLabリポジトリから取得された、NetScaler Consoleに存在するすべてのStyleBookのリストを表示できます。
GitHub/GitLabからStyleBookとConfigPackをインポートする手順
前提条件を完了したら、以下の手順に従ってGitHub/GitLabリポジトリからStyleBookとConfigPackをインポートします。
-
オプション: リポジトリを追加していない場合は追加します。
-
「リポジトリ」ページでリポジトリを選択します。
-
同期をクリックします。