GitHubリポジトリからStyleBookをインポートして同期する
開発にCI/CDプロセスを使用しているシナリオを考えてみましょう。または、すべてのアプリケーションソースコードとデプロイオブジェクトをGitHubで管理しているシナリオを考えてみましょう。
GitHubリポジトリでは、NetScaler構成をデプロイし、これらのStyleBookを管理するために、いくつかのStyleBookを作成しているかもしれません。これらのStyleBookは、Citrix Applications and Delivery Management (ADM) でも必要です。これで、これらのStyleBookをNetScaler ADMに直接インポートできます。GitHubから手動でコピーしてNetScaler ADMにアップロードしたり、ADMとGitHubの両方でファイルを手動で同期したりする必要はありません。
NetScaler® ADMで、GitHubリポジトリを表すリポジトリを定義できるようになりました。GitHubリポジトリのURLと、GitHubで作成したユーザー名とパスワード（またはAPIトークン）を指定します。つまり、GitHubで有効なアカウントを持つ認証済みユーザーのみがStyleBookをインポートおよび同期できます。
リポジトリを作成したら、NetScaler ADMをGitHubリポジトリと同期できます。NetScaler ADMはGitHubに接続し、そのリポジトリで見つかったStyleBookをインポートします。その後、ADMはStyleBookを検証し、NetScaler ADMのStyleBookリストに追加します。検証に失敗したStyleBookはNetScaler ADMに追加されません。エラーを修正し、更新されたバージョンをGitHubリポジトリにコミットしてください。後で、それらをNetScaler ADMに再度インポートまたは同期を試すことができます。
注
-
StyleBookファイルは、GitHubリポジトリの任意のブランチからインポートおよび同期できます。
-
依存するStyleBookが関連付けられているStyleBookもインポートおよび同期できます。
-
GitHubリポジトリからのStyleBookの同期は、NetScaler ADM GUIまたはAPIから手動で開始する必要があります。つまり、現在、StyleBookのインポートと同期は、GitHubのコミットアクティビティに基づいて自動的に行われるわけではありません。
リポジトリを追加し、GitHubリポジトリからStyleBookをインポートする
開始する前に、GitHubに有効なアカウントがあることを確認してください。
GitHubリポジトリ内の任意のフォルダーからADMにStyleBookファイルをインポートできます。
-
NetScaler ADMで、Applications > StyleBooks > Repositories の順に移動します。
-
Add をクリックします。Add Repository ウィンドウで、次のパラメーターを入力します。
-
名前。リポジトリの名前を入力します。この名前は、GitHubのリポジトリ名と同じでも、異なるものでも構いません。
-
リポジトリURL。GitHubリポジトリのURLを入力します。
-
ユーザー名とパスワード。GitHubアカウントにアクセスするためのユーザー名とパスワードを入力します。
注パスワードの代わりにAPIトークンを指定することもできます。APIトークンは、HTTPS経由でGitHubにアクセスする際のパスワードの代わりに使用できます。GitHubリポジトリのAPIトークンの作成方法については、GitHubドキュメントの個人アクセストークンの作成を参照してください。 -
-
作成をクリックします。
リポジトリがNetScaler ADMに作成されます。 -
StyleBookをインポートまたは同期するには、リポジトリページでリポジトリを選択し、同期をクリックします。
ここで使用できるその他のアクションは次のとおりです。
-
編集。リポジトリのURL、ユーザー名、パスワード（またはAPIトークン）を編集できます。
-
削除。リポジトリと、以前にそのGitHubリポジトリからインポートされたNetScaler ADMに存在するすべてのStyleBookを削除できます。注ConfigPackが関連付けられているStyleBookがある場合、NetScaler ADMからリポジトリを削除することはできません。まず、これらのStyleBookのすべての構成パックを削除します。その後、NetScaler ADMからリポジトリを削除して、そのリポジトリからStyleBookをクリーンアップできます。
-
リセット。NetScaler ADMからリポジトリのエントリを実際に削除することなく、そのリポジトリから同期されたNetScaler ADM内のすべてのStyleBookを削除できます。
-
ファイルの一覧表示。GitHubリポジトリから取得されたNetScaler ADMに存在するすべてのStyleBookのリストを表示できます。