Azure Local および Windows Server 上の AKS でオフライン ダウンロードを使用する
適用対象: Azure Local 22H2 上の AKS、Windows Server 上の AKS
展開場所に信頼性の低いインターネット接続がある場合、または展開前にファイルとイメージをスキャンしてセキュリティとコンプライアンスを確保する必要がある場合は、オフライン ダウンロードを使用してローカル パスからインストールまたは更新できます。 この機能を使用する方法は 2 つあります。 onsite または offsite。 オンサイトとは、デプロイ先と同じ場所にある Azure ローカル イメージに AKS をダウンロードすることを意味します。 オフサイトとは、Azure ローカル イメージ上の AKS を別の場所 (インターネット接続が向上する可能性がある場所) にダウンロードし、選択したツールを使用してイメージをデプロイ サイトに転送し、ローカルにインストールまたは更新することを意味します。
オンサイトとオフサイトのどちらのシナリオでも、最新の変更により、インストール/更新プロセス中に異なるバージョンのすべての zip/cab ファイルが確実に抽出されます。 このプロセスでは、以前よりも少ない領域を使用するため、インストール/アップグレードの前にファイルを抽出し、クラスター ストレージに格納する必要があります。
開始する前に
以下の前提条件が必要です。
- AKS-HCI PowerShell モジュールの最新リリース。
- PowerShell を管理者として開きます。
- すべての システム要件 前提条件を満たしていることを確認します。
オフライン ダウンロードを使用してオンサイトにインストールする
手順 1: デプロイ用にマシンを準備する
次のコマンドを実行して、すべての物理ノードを確認して、Azure Local に AKS をインストールするためのすべての要件が満たされているかどうかを確認します。
Initialize-AksHciNode
手順 2: オフライン ダウンロードを使用してイメージをダウンロードするようにデプロイを構成する
構成手順では、 Set-AksHciConfig を使用して、 -offlineDownload
パラメーターを使用したオフライン ダウンロードを有効にします。 次に、 -stagingShare
パラメーターを使用してローカル パスを指定します。 ここでイメージがダウンロードされます。
Set-AksHciConfig -offlineDownload $true -mode full -stagingShare c:\akshciimages -imageDir c:\clusterstorage\volume1\Images -workingDir c:\ClusterStorage\Volume1\ImageStore -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Note
このコマンドは例です。 パラメーター引数は、デプロイに合った引数に置き換える必要があります。 また、 vnet
の設定も行う必要があります。 このクイック スタートの手順 2 を参照してください。 この例では、フル モードでダウンロードします。 ダウンロード モードの詳細については、-mode
の パラメーターの説明を参照してください。
手順 3: オフライン ダウンロードが有効になっており、ローカル パスが正しいことを確認する
次のコマンドを実行して、オフライン ダウンロードが有効であること、およびローカル パスが正しいことを確認できます。
Get-AksHciConfig | ConvertTo-Json
出力は、 offlineDownload
が true
に設定され、 stagingShare
値がローカル パスであることを示しています。
手順 4: Azure にログインし、登録設定を構成する
Azure サブスクリプション情報を使用して、次のコマンドを実行します。
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
手順 5: 新しいデプロイを開始する
次のコマンドを実行してデプロイを開始します。
Install-AksHci
オフライン ダウンロードを使用してオンサイトでアップグレードする
手順 1: Azure ローカル ホストの更新プログラムで利用可能な AKS を取得する
次のコマンドを実行して、使用可能な更新プログラムがあるかどうかを確認します。
Get-AksHciUpdates
手順 2: オフライン ダウンロードを有効にする
オフライン ダウンロードをまだ有効にしていない場合は、イメージをダウンロードするローカル パスで次のコマンドを実行します。 オフライン ダウンロードが正しいローカル パスで true
に設定されているかどうかを確認するには、 Get-AksHciConfig | ConvertToJson
を実行し、値を確認します。
true
に設定されていて、ローカル パスが正しい場合は、手順 3 に進みます。
Enable-AksHciOfflineDownload -stagingShare <your path>
手順 3: アップグレード イメージをダウンロードする
次のコマンドを実行して、イメージをダウンロードします。 この例では、フル モードでダウンロードします。 ダウンロード モードの詳細については、-mode
の パラメーターの説明を参照してください。
Get-AksHciRelease -mode full
手順 4: Azure ローカル ホストの更新プログラムで AKS を開始する
次のコマンドを実行して更新を開始します。
Update-AksHci
オフライン ダウンロードを使用してオフサイトをインストールする
オフサイト機能を使用して、イメージを選択した別の場所にダウンロードします。 これは、より信頼性が高く、セキュリティで保護された接続がある場所である可能性があります。
手順 1: オフサイト構成を設定する
必要な AKS on Azure Local のバージョンを使用して、オフサイトの場所で次のコマンドを実行します。
Set-AksHciOffsiteConfig -version <String> -stagingShare <String>
手順 2: イメージをダウンロードする
次のコマンドを実行して、イメージをダウンロードします。 この例では、フル モードでダウンロードします。 ダウンロード モードの詳細については、-mode
の パラメーターの説明を参照してください。
Get-AksHciRelease -mode full
手順 3: デプロイする場所にオンサイトでイメージを転送する
この手順では、選択したツールを使用してイメージを転送し、AKS on Azure Local がデプロイされているオンサイトのローカル ディレクトリでイメージを使用できるようにします。
手順 4: オンサイトでデプロイを構成する
構成を設定し、必ず -offlineDownload
フラグを使用し、インストール時に AKS on Azure Local がイメージを検索する場所へのパスを設定します。
Set-AksHciConfig -offlineDownload $true -offsiteTransferCompleted $true -stagingShare c:\akshciimages -imageDir c:\clusterstorage\volume1\Images -workingDir c:\ClusterStorage\Volume1\ImageStore -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
手順 5: オフライン ダウンロードがオンで、ローカル パスが正しいことを確認する
次のコマンドを実行して、オフライン ダウンロードが有効であること、およびローカル パスが正しいことを確認できます。
Get-AksHciConfig | ConvertTo-Json
出力は、 offlineDownload
が true
に設定され、 stagingShare
値がローカル パスであることを示しています。
手順 6: Azure にログインし、登録設定を構成する
Azure サブスクリプション情報を使用して、次のコマンドを実行します。
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
手順 7: 新しいデプロイを開始する
次のコマンドを実行してデプロイを開始します。
Install-AksHci
オフライン ダウンロードを使用してオフサイトをアップグレードする
オフサイト機能を使用して、イメージを選択した別の場所にダウンロードします。 これは、より信頼性が高く、セキュリティで保護された接続がある場所である可能性があります。
手順 1: オフサイト構成を設定する
必要な AKS on Azure Local のバージョンを使用して、オフサイトの場所で次のコマンドを実行します。
Set-AksHciOffsiteConfig -version <String> -stagingShare <String>
手順 2: イメージをダウンロードする
イメージをダウンロードするために必要なアップグレード バージョンで次のコマンドを実行します。 この例では、フル モードでダウンロードします。 ダウンロード モードの詳細については、-mode
の パラメーターの説明を参照してください。
Get-AksHciRelease -mode full
手順 3: デプロイする場所にオンサイトでイメージを転送する
この手順では、選択したツールを使用してイメージを転送し、AKS on Azure Local がデプロイされているオンサイトのローカル ディレクトリで使用できるようにします。
手順 4: オフライン ダウンロードを有効にする
オフライン ダウンロードをまだ有効にしていない場合は、次のコマンドを実行してオフライン ダウンロードを有効にし、イメージが配置されている場所への正しいパスを指定します。
Enable-AksHciOfflineDownload -stagingShare <your path> -offsiteTransferCompleted $true
手順 5: 更新プログラムを開始する
次のコマンドを実行して更新を開始します。
Update-AksHci