Set-AksHciConfig

[アーティクル]
05/11/2023

構文

Azure Kubernetes Service ホストの構成設定を設定または更新します。

構文

ホストの構成を設定します

Set-AksHciConfig  -imageDir <String>
                  -workingDir <String>
                  -cloudConfigLocation <String>
                  -vnet <Virtual Network>
                 [-createAutoConfigContainers {true, false}]
                 [-offlineDownload]
                 [-offsiteTransferCompleted]
                 [-mode {minimum, full}]
                 [-stagingShare <String>]
                 [-nodeConfigLocation <String>]
                 [-controlPlaneVmSize <VmSize>]
                 [-sshPublicKey <String>]
                 [-macPoolStart <String>]
                 [-macPoolEnd <String>]       
                 [-proxySettings <ProxySettings>]
                 [-cloudServiceCidr <String>]
                 [-version <String>]
                 [-nodeAgentPort <int>]
                 [-nodeAgentAuthorizerPort <int>]
                 [-cloudAgentPort <int>]
                 [-cloudAgentAuthorizerPort <int>]
                 [-clusterRoleName <String>]
                 [-cloudLocation <String>]
                 [-concurrentDownloads <int>]
                 [-skipHostLimitChecks]
                 [-skipRemotingChecks]
                 [-skipValidationChecks]
                 [-insecure]
                 [-skipUpdates]
                 [-forceDnsReplication]

説明

Azure Kubernetes Service ホストの構成設定を設定します。 2 から 4 ノードの Azure Stack HCI クラスターまたは Windows Server 2019 Datacenter フェールオーバークラスターにデプロイする場合は、-workingDir および -cloudConfigLocation パラメーターを指定する必要があります。単一ノードの Windows Server 2019 Datacenter の場合、すべてのパラメーターは省略可能であり、既定値に設定されます。ただし、最適なパフォーマンスを得るには、2 から 4 ノードの Azure Stack HCI クラスターのデプロイを使用することをお勧めします。

例

DHCP ネットワークを使用して 2 から 4 ノードのクラスターにデプロイするには

PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" 

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

静的 IP ネットワークを使用してデプロイするには

PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -k8snodeippoolstart "172.16.10.0" -k8snodeippoolend "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipaddressprefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsservers "172.16.0.1" 

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

プロキシサーバーを使用してデプロイするには

PS C:\> $proxySettings = New-AksHciProxySetting -name "corpProxy" -http http://contosoproxy:8080 -https https://contosoproxy:8443 -noProxy localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16 -credential $proxyCredential

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -proxySetting $proxySettings -vnet $vnet -cloudservicecidr "172.16.10.10/16"

パラメーター

-imageDir

AKS ハイブリッドが VHD イメージを格納するディレクトリへのパス。このパラメーターは必須です。パスは、などの C:\ClusterStorage\Volume2\ImageStore共有ストレージパス、または SMB 共有 (など \\FileShare\ImageStore) を指す必要があります。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: %systemdrive%\AksHciImageStore
Accept pipeline input: False
Accept wildcard characters: False

-workingDir

小さなファイルの格納に使用するモジュールの作業ディレクトリ。このパラメーターは必須です。パスは、などの c:\ClusterStorage\Volume2\ImageStore共有ストレージパスを指す必要があります。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: %systemdrive%\AksHci
Accept pipeline input: False
Accept wildcard characters: False

-cloudConfigLocation

クラウドエージェントが構成を格納する場所。このパラメーターは必須です。パスは、などの C:\ClusterStorage\Volume2\ImageStore共有ストレージパス、またはなどの SMB 共有 \\FileShare\ImageStoreを指す必要があります。ストレージに常にアクセスできるように、場所は高可用性共有上にある必要があります。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False

-vnet

コマンドで作成された AksHciNetworkSetting オブジェクトの New-AksHciNetworkSetting 名前。

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-createAutoConfigContainers

クラスター共有ボリューム (CSV) での VM データの自動配布を無効にすることができます。自動分散を無効にするには、このパラメーターの引数として false を使用します。自動配布が無効になっている場合は、選択した imageDir CSV のみが使用されます。既定値は true です。

Type: System.Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-offlineDownload

Install-AksHci 中にオフラインダウンロードを呼び出します。 Enable-AksHciOfflineDownload も実行する必要があります。このフラグは、パラメーターと組み合 -stagingShare わせて使用されます。

Type: System.Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-offsiteTransferCompleted

インストール時にオフサイトでダウンロードされ、展開サーバーに転送された成果物を使用するようにデプロイを設定します。このフラグは、および -stagingShare パラメーターと組み合わせて-offlineDownload使用されます。

-モード

オフラインダウンロードに使用するダウンロードモード。 AKS ハイブリッドデプロイの最小イメージが必要な場合は、を使用 minimum します。このオプションには、必要な Linux イメージと、必要な Kubernetes イメージのみが含まれます。 AKS ハイブリッドデプロイ用のすべてのイメージが必要な場合は、を使用 full します。このオプションには、すべての Linux イメージと Windows イメージと、サポートされているすべての Kubernetes イメージが含まれます。このパラメーターは、パラメーターと組み合わせて -offlineDownload 使用します。既定値は、full です。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False

-stagingShare

イメージをダウンロードするローカルパス。パラメーターと組み合わせて使用 offlineDownload します。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-nodeConfigLocation

ノードエージェントが構成を格納する場所。すべてのノードにはノードエージェントがあるため、その構成はそのノードに対してローカルです。この場所はローカルパスである必要があります。既定では、すべてのデプロイで %systemdrive%\programdata\wssdagent になります。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: %systemdrive%\programdata\wssdagent
Accept pipeline input: False
Accept wildcard characters: False

-controlPlaneVmSize

コントロールプレーン用に作成する VM のサイズ。使用できる VM サイズの一覧を取得するには、Get-AksHciVmSize を実行します。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Standard_A4_V2
Accept pipeline input: False
Accept wildcard characters: False

-sshPublicKey

SSH 公開キーファイルへのパス。この公開キーを使用すると、AKS ハイブリッドデプロイによって作成された任意の VM にログインできます。独自の SSH 公開キーがある場合は、ここでその場所を渡します。キーが指定されていない場合は、.pub の下で %systemdrive%\akshci\.ssh\akshci_rsaキーを探します。ファイルが存在しない場合は、SSH キーペアがこの場所に生成され、使用されます。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolStart

Azure Kubernetes Service ホスト VM に使用する MAC プールの MAC アドレスの先頭を指定します。 MAC アドレスの構文では、最初のバイトの下位ビットは常に 0 で、最初のバイトは常に偶数である必要があります (つまり、00、02、04、06..)。一般的な MAC アドレスは、02:1E:2B:78:00:00 のようになります。割り当てられる MAC アドレスが一貫性のあるものになるように、長期間維持されるデプロイには MAC プールを使用します。 MAC プールは、VM に特定の MAC アドレスが割り当てられる必要がある場合に便利です。既定値は、None です。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolEnd

Azure Kubernetes Service ホスト VM に使用する MAC プールの MAC アドレスの末尾を指定します。 MAC アドレスの構文では、先頭のバイトの最下位ビットが常に 0 である必要があります。また、先頭のバイトは常に偶数 (つまり、00、02、04、06...) である必要があります。-macPoolEnd として渡されたアドレスの先頭のバイトは、-macPoolStart として渡されたアドレスの先頭のバイトと同じである必要があります。割り当てられる MAC アドレスが一貫性のあるものになるように、長期間維持されるデプロイには MAC プールを使用します。 MAC プールは、VM に特定の MAC アドレスが割り当てられる必要がある場合に便利です。既定値は、None です。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-proxySettings

New-AksHciProxySetting を使用して作成されたプロキシオブジェクト。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-cloudServiceCidr

MOC CloudAgent サービスに割り当てる静的 IP/ネットワークプレフィックスを提供します。この値は CIDR 形式を使用して指定する必要があります。たとえば、 192.168.1.2/16 などです。 IP アドレスが変更されないため、このパラメーターを指定して、ネットワーク上の重要な情報に常にアクセスできるようにすることができます。既定値は、None です。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-version

デプロイする AKS ハイブリッドのバージョン。既定値は最新バージョンです。既定値は変更しないことをお勧めします。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False

-nodeAgentPort

ノードエージェントがリッスンする必要がある TCP/IP ポート番号。既定値は 45000 です。  既定値は変更しないことをお勧めします。

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False

-nodeAgentAuthorizerPort

ノードエージェントで承認ポートに使用する必要がある TCP/IP ポート番号。既定値は 45001 です。既定値は変更しないことをお勧めします。

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False

-cloudAgentPort

クラウドエージェントがリッスンする必要がある TCP/IP ポート番号。既定値は 55000 です。既定値は変更しないことをお勧めします。

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False

-cloudAgentAuthorizerPort

クラウドエージェントが承認ポートに使用する必要がある TCP/IP ポート番号。既定値は 65000 です。既定値は変更しないことをお勧めします。

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False

-clusterRoleName

クラスター内で汎用サービスとしてクラウドエージェントを作成するときに使用する名前を指定します。このパラメーターの既定値は、 プレフィックス ca と GUID サフィックスを持つ一意の名前です。既定値は変更しないことをお勧めします。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: A unique name with a prefix of ca- and a guid suffix
Accept pipeline input: False
Accept wildcard characters: False

-cloudLocation

Microsoft が運営するカスタムクラウドの場所の名前を提供します。既定の名前は MocLocation です。既定値は変更しないことをお勧めします。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False

-skipHostLimitChecks

デプロイを続行する前に、メモリとディスク領域が使用可能であることを確認するためのチェックをスクリプトでスキップするように要求します。この設定を使用することは推奨されません。

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipRemotingChecks

ローカルノードとリモートノードの両方に対するリモート処理機能を確認するためのチェックをスクリプトでスキップするように要求します。この設定を使用することは推奨されません。

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-insecure

セキュリティで保護されていないモード (TLS で保護された接続なし) で、クラウドエージェントやノードエージェントなどの AKS ハイブリッドコンポーネントをデプロイします。   運用環境に、セキュリティ保護されていないモードを使用しないことをお勧めします。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipUpdates

利用可能な更新プログラムをスキップする場合は、このフラグを使用します。この設定を使用することは推奨されません。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-forceDnsReplication

一部のシステムでは、DNS レプリケーションに最大 1 時間かかることがあります。これにより、デプロイが遅くなります。この問題が発生した場合は、ループでスタックしている Install-AksHci ことがわかります。この問題を解決するには、このフラグを使用してみてください。 -forceDnsReplication フラグは、保証されている修正プログラムではありません。フラグの背後にあるロジックが失敗した場合、エラーは非表示になり、フラグが指定されていないかのようにコマンドが続行されます。

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipValidationChecks

環境インフラストラクチャとユーザー構成入力の検証チェックをスキップする場合は、このフラグを使用します。これらのチェックでは、インストールを続行する前に対処する必要がある潜在的な問題が強調表示されています。この設定を使用することは推奨されません。

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

次のステップ

AksHci PowerShell リファレンス