外部リポジトリからスタイルブックをインポートして同期する

開発に CI/CD プロセスを使用しているシナリオを考えてみましょう。 または、すべてのアプリケーション ソース コードとデプロイメント オブジェクトを GitHub/GitLab で管理するシナリオ。

GitHub/GitLab リポジトリでは、NetScaler 構成を展開し、これらの StyleBook を管理するための StyleBook が複数作成されている場合があります。 これらの StyleBook は NetScaler コンソールでも必要です。 これで、これらの StyleBook を NetScaler コンソールに直接インポートできるようになりました。 GitHub/GitLab から手動でコピーして NetScaler コンソールにアップロードしたり、NetScaler コンソールと GitHub/GitLab の両方でファイルを手動で同期したりする必要はありません。

StyleBook と構成パックをインポートするには、NetScaler コンソールで GitHub/GitLab リポジトリを表すリポジトリを定義します。 GitHub/GitLab リポジトリの URL とユーザー名、GitHub/GitLab で作成された API または個人アクセス (PA) トークンを指定します。 つまり、GitHub/GitLab で有効なアカウントを持つ承認済みユーザーだけが StyleBook をインポートおよび同期できます。

次の種類のリポジトリをインポートおよび同期できます。

• パブリックにアクセス可能なリポジトリ - パブリックに公開されており、インターネット経由でアクセスできるリポジトリ。
• オンプレミスまたはプライベート GitLab/GitHub リポジトリ - プライベートにホストされ、通常は企業のイントラネット内でのみアクセス可能なリポジトリ。 これらのリポジトリの場合、登録プロセス中に NetScaler エージェントを選択する必要があります。 NetScaler エージェントは、企業のイントラネット内のリポジトリにアクセスするためのプロキシとして機能します。

リポジトリを作成したら、NetScaler コンソールを GitHub/GitLab リポジトリと同期できます。 NetScaler コンソールは GitHub/GitLab に接続し、そのリポジトリにある StyleBook をインポートします。 NetScaler コンソールは StyleBook を検証し、NetScaler コンソールの StyleBook のリストに追加します。 検証に失敗した場合、StyleBook は NetScaler コンソールに追加されません。 エラーを修正し、更新されたバージョンを GitHub/GitLab リポジトリにコミットします。 後で、それらを NetScaler コンソールに再度インポートするか、同期してみてください。

注記

• StyleBooks ファイルは、GitHub/GitLab リポジトリの任意のブランチからインポートおよび同期できます。

• 依存するスタイルブックが関連付けられているスタイルブックをインポートして同期することもできます。

• GitHub/GitLab リポジトリからの StyleBook の同期は、NetScaler コンソールの GUI または API から手動で開始する必要があります。 つまり、現在、StyleBook のインポートと同期は、GitHub/GitLab のコミット アクティビティに基づいて自動的には行われません。

リポジトリを追加し、外部リポジトリからスタイルブックをインポートする

始める前に、GitHub/GitLab に有効なアカウントがあることを確認してください。

GitHub/GitLab リポジトリ内の任意のフォルダーから StyleBook ファイルを NetScaler コンソールにインポートできます。

1. NetScaler コンソールで、 アプリケーション > スタイルブック > リポジトリに移動します。

2. 追加をクリックします。 リポジトリの追加 ウィンドウで、次のパラメータを入力します。

   • 名前。 リポジトリの名前を入力します。 この名前は、GitHub/GitLab のリポジトリ名と同じでも、別の名前でもかまいません。

   • リポジトリ URL - GitHub/GitLab リポジトリ URL を入力します。

     GitHub/GitLab エンタープライズ URL を指定できます。 GitHub/GitLab エンタープライズ アカウントから StyleBook や構成パックをインポートまたは同期するのに役立ちます。

   • プライベート URL ですか? - リポジトリがオンプレミスまたはプライベート GitLab/GitHub リポジトリの場合は、このチェックボックスをオンにして、 エージェントを選択します。

   • ユーザー名とパスワード。 GitHub/GitLab アカウントにアクセスするためのユーザー名とパスワードを入力します。

注記

パスワードの代わりに API トークンを提供することもできます。 API トークンは、HTTPS 経由の GitHub/GitLab のパスワードの代わりに使用できます。 GitHub/GitLab リポジトリの API/PA トークンを作成する方法については、GitHub/GitLab のドキュメントの 個人アクセス トークンの作成を参照してください。

1. 作成をクリックします。

   

   

   リポジトリは NetScaler コンソールに作成されます。

2. StyleBook をインポートまたは同期するには、[ リポジトリ ] ページでリポジトリを選択し、[ 同期] をクリックします。

ここで使用できる他のアクションは次のとおりです。

• 編集。 リポジトリの URL、ユーザー名、パスワード (または API トークン) を編集できます。

• を削除します。 NetScaler コンソールに存在する、以前に GitHub/GitLab リポジトリからインポートされたすべての StyleBook とともにリポジトリを削除できます。

注記

ConfigPack が関連付けられている StyleBook がある場合は、NetScaler コンソールからリポジトリを削除することはできません。 まず、これらのスタイルブックのすべての構成パックを削除します。 後で NetScaler コンソールからリポジトリを削除して、そのリポジトリから StyleBook をクリーンアップすることができます。

• をリセットします。 NetScaler コンソールからリポジトリ エントリを実際に削除しなくても、そのリポジトリから同期された NetScaler コンソール内のすべての StyleBook を削除できます。

• ファイルを一覧表示します。 NetScaler コンソールに存在する、GitHub/GitLab リポジトリから生成されたすべての StyleBook のリストを表示できます。

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

前提条件を満たしたら、次の手順に従って GitHub/GitLab リポジトリから StyleBook と構成パックをインポートします。

1. オプション: リポジトリを追加していない場合は追加します。

2. 「リポジトリ」ページでリポジトリを選択します。

3. 同期をクリックします。