外部リポジトリからのStyleBookのインポートと同期
開発にCI/CDプロセスを使用しているシナリオ、またはすべてのアプリケーションソースコードとデプロイオブジェクトをGitHub/GitLabで管理しているシナリオを検討します。
GitHub/GitLabリポジトリでは、NetScaler構成をデプロイし、これらのStyleBookを管理するためにいくつかのStyleBookを作成している場合があります。これらのStyleBookはNetScaler Consoleでも必要です。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もインポートおよび同期できます。
GitHub/GitLabリポジトリからのStyleBookの同期は、NetScaler Console GUIまたはAPIから手動で開始する必要があります。つまり、現在、StyleBookのインポートと同期は、GitHub/GitLabのコミットアクティビティに基づいて自動的に行われるわけではありません。
外部リポジトリからのリポジトリの追加と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と構成パックのインポート手順
前提条件を完了したら、GitHub/GitLabリポジトリからStyleBookと構成パックをインポートする手順に従います。
-
オプション：リポジトリを追加していない場合は追加します。
-
Repositories ページでリポジトリを選択します。
-
Sync をクリックします。