Adicionar um certificado de aplicativo a um cluster do Service Fabric

Artigo
10/15/2024

Este script de exemplo orienta como criar um certificado no Key Vault e, em seguida, implantá-lo em um dos conjuntos de dimensionamento de máquinas virtuais em que o cluster é executado. Esse cenário não usa Service Fabric diretamente, mas depende de Key Vault e em conjuntos de dimensionamento de máquinas virtuais.

Observação

Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.

Se necessário, instale o Azure PowerShell usando as instruções encontradas no Guia do Azure PowerShell e, em seguida, execute Connect-AzAccount para criar uma conexão com o Azure.

Criar um certificado no Key Vault

$VaultName = ""
$CertName = ""
$SubjectName = "CN="

$policy = New-AzKeyVaultCertificatePolicy -SubjectName $SubjectName -IssuerName Self -ValidityInMonths 12
Add-AzKeyVaultCertificate -VaultName $VaultName -Name $CertName -CertificatePolicy $policy

Ou faça upload de um certificado existente para o Key Vault

$VaultName= ""
$CertName= ""
$CertPassword= ""
$PathToPFX= ""

$bytes = [System.IO.File]::ReadAllBytes($PathToPFX)
$base64 = [System.Convert]::ToBase64String($bytes)
$jsonBlob = @{
   data = $base64
   dataType = 'pfx'
   password = $CertPassword
   } | ConvertTo-Json
$contentbytes = [System.Text.Encoding]::UTF8.GetBytes($jsonBlob)
$content = [System.Convert]::ToBase64String($contentbytes)

$SecretValue = ConvertTo-SecureString -String $content -AsPlainText -Force

# Upload the certificate to the key vault as a secret
$Secret = Set-AzKeyVaultSecret -VaultName $VaultName -Name $CertName -SecretValue $SecretValue

Atualizar perfil dos conjuntos de dimensionamento de máquinas virtuais com certificado

$ResourceGroupName = ""
$VMSSName = ""
$CertStore = "My" # Update this with the store you want your certificate placed in, this is LocalMachine\My

# If you have added your certificate to the keyvault certificates, use
$CertConfig = New-AzVmssVaultCertificateConfig -CertificateUrl (Get-AzKeyVaultCertificate -VaultName $VaultName -Name $CertName).SecretId -CertificateStore $CertStore

# Otherwise, if you have added your certificate to the keyvault secrets, use
$CertConfig = New-AzVmssVaultCertificateConfig -CertificateUrl (Get-AzKeyVaultSecret -VaultName $VaultName -Name $CertName).Id -CertificateStore $CertStore

$VMSS = Get-AzVmss -ResourceGroupName $ResourceGroupName -VMScaleSetName $VMSSName

# If this KeyVault is already known by the virtual machine scale set, for example if the cluster certificate is deployed from this keyvault, use
$VMSS.virtualmachineprofile.osProfile.secrets[0].vaultCertificates.Add($CertConfig)

# Otherwise use
$VMSS = Add-AzVmssSecret -VirtualMachineScaleSet $VMSS -SourceVaultId (Get-AzKeyVault -VaultName $VaultName).ResourceId  -VaultCertificate $CertConfig

Atualizar conjunto de dimensionamento de máquinas virtuais

Update-AzVmss -ResourceGroupName $ResourceGroupName -VirtualMachineScaleSet $VMSS -VMScaleSetName $VMSSName

Se você quiser que o certificado seja colocado em vários tipos de nó no cluster, a segunda e terceira partes desse script devem ser repetidas para cada tipo de nó que deve ter o certificado.

Explicação sobre o script

Este script usa os seguintes comandos: Cada comando da tabela é vinculado à documentação específica do comando.

Comando	Observações
New-AzKeyVaultCertificatePolicy	Cria uma política na memória que representa o certificado
Add-AzKeyVaultCertificate	Implanta a política para Certificados do Key Vault
Set-AzKeyVaultSecret	Implanta a política para Segredos do Key Vault
New-AzVmssVaultCertificateConfig	Cria uma configuração na memória que representa o certificado em uma VM
Get-AzVmss
Add-AzVmssSecret	Adiciona o certificado à definição na memória do conjunto de dimensionamento de máquinas virtuais
Update-AzVmss	Implanta a nova definição do conjunto de dimensionamento de máquinas virtuais

Próximas etapas

Para obter mais informações sobre o módulo do Azure PowerShell, confira Documentação do Azure PowerShell.

Exemplos adicionais do Azure PowerShell para o Azure Service Fabric podem ser encontrados nos exemplos do Azure PowerShell.

Compartilhar via