Application Delivery Management

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で作成したGitHubリポジトリのURLとユーザー名、パスワード(または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ファイルをインポートできます。

  1. NetScaler ADMで、Applications > StyleBooks > Repositories に移動します。

  2. Add をクリックします。Add Repository ウィンドウで、次のパラメータを入力します。

    • Name。リポジトリの名前を入力します。この名前は、GitHubのリポジトリ名と同じでも、異なるものでも構いません。

    • Repository URL。GitHubリポジトリのURLを入力します。

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

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

  3. Create をクリックします。

    GITリポジトリの追加

    リポジトリがNetScaler ADMに作成されます。

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

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

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

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

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

  • Reset。NetScaler ADMからリポジトリエントリを実際に削除することなく、そのリポジトリから同期されたNetScaler ADM内のすべてのStyleBookを削除できます。

  • List files。GitHubリポジトリから取得された、NetScaler ADMに存在するすべてのStyleBookのリストを表示できます。

GitHubリポジトリからのStyleBookのインポートと同期