<book_title> を検索 ...

Cluster Server 8.0.2 付属エージェントリファレンスガイド - Linux

Last Published: 2023-07-18

Product(s): InfoScale & Storage Foundation (8.0.2)

Platform: Linux

AzureDisk エージェント

Azure の仮想マシンは、データディスクを使用してアプリケーションデータを保存します。AzureDisk エージェントは、管理対象および管理対象外のデータディスクをサポートし、アプリケーションのフェールオーバー時にこれらのディスクの高可用性を提供します。

AzureDisk エージェントは、管理対象と管理対象外の Azure データディスクをオンライン化またはオフライン化したり、監視したりします。エージェントは、管理対象および管理対象外のデータディスクを、同じリソースグループまたは異なるリソースグループの仮想マシンに接続します。AzureDisk エージェントは、Azure Python SDK を使用して、Azure データディスクが Azure 仮想マシンに接続されているかどうかを判断します。

前提条件

Azure サブスクリプションを認証するための認証方法を設定します。

AzureAuth エージェントをサービスプリンシパルベースの認証に使用するには、AzureAuth エージェントを設定します。
AzureAuth エージェントを参照してください。
Azure のマネージド ID ベースの認証を使用するには、クラスタでユーザー割り当てマネージド ID を設定します。
Azure のマネージド ID の使用を参照してください。

依存関係

Azure サブスクリプションを認証するために Azure のマネージド ID が設定されている場合、AzureDisk リソースは AzureAuth リソースに依存しません。
AzureAuth エージェントがサービスプリンシパルベースの認証用に設定されている場合、AzureDisk リソースは AzureAuth リソースに依存します。

図: サービスグループ依存関係の例 (AzureAuth エージェントを使用している場合)

os_linサービスグループ依存関係の例 (AzureAuth エージェントを使用している場合)

エージェント関数

Open	Azure VM の名前をフェッチします。
Online	Azure VM に Azure データディスクを接続します。
Offline	Azure VM から Azure データディスクを切断します。
Monitor	Azure データディスクが現在の Azure VM に接続されているかどうかを判断します。
Clean	進行中のすべてのリソースアクションを終了し、Azure VM から Azure データディスクを切断します。

状態の定義

ONLINE	Azure データディスクが Azure VM に接続されていることを示します。
OFFLINE	Azure データディスクが Azure VM から切断されていることを示します。
FAULTED	Azure データディスクが、VCS 制御外の Azure VM から予期せず切断されたことを示します。
UNKNOWN	次のいずれかの理由で問題が発生していることを示します。 Azure Python SDK がインストールされていない。 Azure VM が指定されたリソースグループで見つからない。 Azure データディスクが正しく設定されていない、または ID が無効である。役割が正しく設定されていない、またはインスタンスに関連付けられていない。ディスクが別のクラスタの Azure VM に接続されている。 DiskIds に管理対象ディスクと管理対象外ディスクの組み合わせがある。設定された管理対象外ディスクが異なるストレージアカウントに属している。

属性

表: 必須属性

属性	説明
DiskIds	管理対象ディスクの場合は、ディスクのリソース ID。管理対象外ディスクの場合は、ディスクの VHDUri。 1 つ以上のディスク ID を追加できます。複数のエントリの区切り文字としてスペースを使用します。データ形式と値のタイプ: 文字列 - ベクトル
VMResourceGroup	Azure VM が存在する Azure リソースグループ。データ形式と値のタイプ: 文字列 - スカラー
AzureAuthResName	Azure 関連の認証を処理する認証エージェントリソースの名前です。この属性は、AzureAuth エージェントが Azure サブスクリプションにサービスプリンシパルベースの認証を使用するように設定されている場合にのみ必要です。この属性は、Azure 認証にマネージド ID を使用する場合は必要ありません。メモ: AzureAuth エージェントとユーザー割り当てマネージド ID の両方がクラスタで設定されている場合、AzureAuth エージェントの設定が優先されます。クラスタは、デフォルトで AzureAuth サービスプリンシパルベースの Azure 認証を使用します。データ形式と値のタイプ: 文字列 - スカラー
ManagedIdentityClientID	Azure ポータルから取得した、ユーザー割り当てマネージド ID の ID です。この属性は、Azure 認証にマネージド ID ベースの認証を使用する場合にのみ必要です。この属性は、AzureAuth エージェントが Azure 認証にサービスプリンシパルを使用するように設定されている場合は必要ありません。メモ: AzureAuth エージェントとユーザー割り当てマネージド ID の両方がクラスタで設定されている場合、AzureAuth エージェントの設定が優先されます。クラスタは、デフォルトで AzureAuth サービスプリンシパルベースの Azure 認証を使用します。データ形式と値のタイプ: 文字列 - スカラー
StorageAccountKey	ストレージアカウントのアクセスキー。 vcsencrypt ユーティリティを使用してこのキーを暗号化する必要があります。詳しくは、『Cluster Server 管理者ガイド』を参照してください。この属性は、管理対象外ディスクが設定されている場合にのみ必要です。データ形式と値のタイプ: 文字列 - スカラー

表: オプションの属性

属性	説明
AzureVMName	エージェントが実行されている Azure の VM の名前。データ形式と値のタイプ: 文字列 - スカラー

属性

説明

AzureVMName

エージェントが実行されている Azure の VM の名前。

データ形式と値のタイプ: 文字列 - スカラー

リソースタイプの定義

type AzureDisk (
    static int FaultOnMonitorTimeouts = 0
    static int MonitorTimeout = 120
    static str ArgList[] = { StorageAccountKey, tempVMName, DiskIds, 
   	VMResourceGroup, AzureVMName, "AzureAuthResName:SubscriptionId",  
   	"AzureAuthResName:ClientId", "AzureAuthResName:SecretKey", 
   	"AzureAuthResName:TenantId", tempSubscriptionId,   
   	ManagedIdentityClientID }
    str DiskIds[]
    str VMResourceGroup
    str AzureVMName
    str AzureAuthResName
    temp str tempVMName
    str StorageAccountKey
    str ManagedIdentityClientID
    temp str tempSubscriptionId
    )

AzureAuth エージェントを使用する設定例

管理対象ディスクを使用する設定例:

AzureDisk azure-res-disk (
    DiskIds = { "/subscriptions/6940a326-fgh6-40dd-b616-c1e9bbdf1d63/
    resourceGroups/azureRG/providers/Microsoft.Compute/disks/
    AzureManagedDisk" }
    VMResourceGroup = "azureVMRG"
    AzureAuthResName = "azure-auth-res"
    )

管理対象外ディスクを使用する設定例:

AzureDisk azure-res-disk (
    DiskIds = { "https://azureunstorageaccount2.blob.core.windows.net/
    vhds/unmanageddisk.vhd" }
    VMResourceGroup = "azureVMRG"
    AzureAuthResName = "azure-auth-res"
    storageAccountKey = fpjNjrNrgRupNnnLhlKHnlRjpKLitIpjTgnTpfNglSls
    )

マネージド ID を使用する設定例

管理対象ディスクを使用する設定例:

AzureDisk azure-res-disk (
    DiskIds = { "/subscriptions/6940a326-fgh6-40dd-b616-c1e9bbdf1d63
    /resourceGroups/azureRG/providers/Microsoft.Compute/disks/
    AzureManagedDisk" }
    VMResourceGroup = "azureVMRG"
    ManagedIdentityClientID = 1da89bd2-9735-4266-b920-27c23b98f022
    )

管理対象外ディスクを使用する設定例:

AzureDisk azure-res-disk (
    DiskIds = {"https://azureunstorageaccount2.blob.core.windows.net
    /vhds/unmanageddisk.vhd" }
    VMResourceGroup = "azureVMRG" 
    ManagedIdentityClientID = 1da89bd2-9735-4266-b920-27c23b98f022
    storageAccountKey = fpjNjrNrgRupNnnLhlKHnlRjpKLitIpjTgnTpfNglSls
    )

デバッグログレベル

AzureDisk エージェントは、DBG_1 デバッグログレベルを使用します。