Atualizar o provedor de recursos mySQL no Azure Stack Hub
Importante
A partir do build 2108 do Azure Stack Hub, os provedores de recursos SQL e MySQL são oferecidos a assinaturas que receberam acesso. Se você quiser começar a usar esse recurso ou se precisar atualizar de uma versão anterior, abra um caso de suporte e nossos engenheiros de suporte orientarão você pelo processo de implantação ou atualização.
Importante
Antes de atualizar o provedor de recursos, examine as notas de versão para saber mais sobre novas funcionalidades, correções e quaisquer problemas conhecidos que possam afetar sua implantação. As notas sobre a versão também especificam a versão mínima do Azure Stack Hub necessária para o provedor de recursos.
Importante
Atualizar o provedor de recursos NÃO atualizará o servidor MySQL de hospedagem.
Quando o Azure Stack Hub lança um novo build, podemos lançar um novo adaptador de provedor de recursos MySQL. Enquanto o adaptador existente continua funcionando, recomendamos atualizar para o build mais recente o mais rápido possível.
| Versão do Azure Stack Hub com suporte | Versão de RP do MySQL | Windows Server no qual o serviço RP está em execução |
|---|---|---|
| 2206, 2301, 2306, 2311 | MySQL RP versão 2.0.13.x | Complemento do Microsoft AzureStack RP Windows Server 1.2009.0 |
| 2108, 2206 | MySQL RP versão 2.0.6.x | Complemento do Microsoft AzureStack RP Windows Server 1.2009.0 |
Atualizar o provedor de recursos do MySQL Server V2
Se você já implantou o MySQL RP V2 e deseja marcar para atualizações, marcar Como aplicar atualizações ao provedor de recursos.
Se você quiser atualizar do MySQL RP V1 para o MySQL RP V2, primeiro atualize para o MySQL RP V1.1.93.x e aplique o processo de atualização de versão principal para atualizar do MySQl RP V1 para o MySQL RP V2.
Atualização do MySQL RP V1.1.93.x para MySQL RP V2.0.6.0
Pré-requisitos
Atualize o MySQL RP V1 para a 1.1.93.x mais recente. Em Assinatura do Provedor Padrão, localize o grupo de recursos rp (formato de nomenclatura: system.
<region>. mysqladapter). Confirme a marca de versão e o nome da VM do MySQL RP no grupo de recursos. Se você ainda estiver em uma versão antiga e precisar atualizar para 1.1.93.x, abra um caso de suporte para obter ajuda.Abra um caso de suporte para obter o pacote MajorVersionUpgrade e adicione sua assinatura à lista de permitidos do marketplace ash para a versão futura da V2.
Baixe o Microsoft AzureStack Add-On RP Windows Server 1.2009.0 para o marketplace.
Verifique se o Azure Stack Hub atende aos pré-requisitos de integração do datacenter.
Pré-requisito Referência O encaminhamento de DNS condicional está definido corretamente. Integração do datacenter do Azure Stack Hub – DNS As portas de entrada para provedores de recursos estão abertas. Integração do datacenter do Azure Stack Hub – Portas e protocolos de entrada A entidade do certificado PKI e a SAN são definidas corretamente. Pré-requisitos de PKI obrigatórios de implantação do Azure Stack Hub
Pré-requisitos de certificado PaaS de implantação do Azure Stack Hub(para ambiente desconectado) Instale os módulos necessários do PowerShell, semelhante ao processo de atualização usado para Implantar o provedor de recursos MySQL.
Prepare o Uri do Conector do MySQL com a versão necessária. Para obter detalhes, consulte Implantar o provedor de recursos MySQL. por exemplo, https://< storageAcountName.blob>.<região>.<FQDN>/<containerName>/mysql-connector-net-8.0.21.msi
Disparar MajorVersionUpgrade
Execute o script a seguir em um console do PowerShell com privilégios elevados para executar a atualização de versão principal.
Observação
Verifique se o computador cliente no qual você executa o script é da versão do sistema operacional não mais antiga do que Windows 10 ou Windows Server 2016 e se o computador cliente tem arquitetura do sistema operacional X64.
Importante
É altamente recomendável usar Clear-AzureRmContext -Scope CurrentUser e Clear-AzureRmContext -Scope Process para limpar o cache antes de executar a implantação ou atualizar o script.
# Check Operating System version
$osVersion = [environment]::OSVersion.Version
if ($osVersion.Build -lt 10240)
{
Write-Host "OS version is too old: $osVersion."
return
}
$osArch = (Get-WmiObject Win32_OperatingSystem).OSArchitecture
if ($osArch -ne "64-bit")
{
Write-Host "OS Architecture is not 64 bit."
return
}
# Check LongPathsEnabled registry key
$regPath = 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem'
$longPathsEnabled = 'LongPathsEnabled'
$property = Get-ItemProperty -Path $regPath -Name $longPathsEnabled -ErrorAction Stop
if ($property.LongPathsEnabled -eq 0)
{
Write-Host "Detect LongPathsEnabled equals to 0, prepare to set the property."
Set-ItemProperty -Path $regPath -Name $longPathsEnabled -Value 1 -ErrorAction Stop
Write-Host "Set the long paths property, please restart the PowerShell."
return
}
# Use the NetBIOS name for the Azure Stack Hub domain.
$domain = "YouDomain"
# For integrated systems, use the IP address of one of the ERCS VMs
$privilegedEndpoint = "YouDomain-ERCS01"
# Provide the Azure environment used for deploying Azure Stack Hub. Required only for Azure AD deployments. Supported values for the <environment name> parameter are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
$AzureEnvironment = "AzureCloud"
# Point to the directory where the resource provider installation files were extracted.
$tempDir = 'C:\extracted-folder\MajorVersionUpgrade-MySQLRP'
# The service admin account can be Azure Active Directory or Active Directory Federation Services.
$serviceAdmin = "admin@mydomain.onmicrosoft.com"
$AdminPass = ConvertTo-SecureString 'xxxxxxxx' -AsPlainText -Force
$AdminCreds = New-Object System.Management.Automation.PSCredential ($serviceAdmin, $AdminPass)
# Add the cloudadmin credential that's required for privileged endpoint access.
$CloudAdminPass = ConvertTo-SecureString 'xxxxxxxx' -AsPlainText -Force
$CloudAdminCreds = New-Object System.Management.Automation.PSCredential ("$domain\cloudadmin", $CloudAdminPass)
# Change the following as appropriate.
$PfxPass = ConvertTo-SecureString 'xxxxxxx' -AsPlainText -Force
# Provide the pfx file path
$PfxFilePath = "C:\tools\mysqlcert\SSL.pfx"
# Local blob uri where stores the required mysql connector
$MySQLConnector = "Provide the MySQL Connector Uri according to Prerequisites step."
# PowerShell modules used by the RP MajorVersionUpgrade are placed in C:\Program Files\SqlMySqlPsh
# The deployment script adds this path to the system $env:PSModulePath to ensure correct modules are used.
$rpModulePath = Join-Path -Path $env:ProgramFiles -ChildPath 'SqlMySqlPsh'
$env:PSModulePath = $env:PSModulePath + ";" + $rpModulePath
. $tempDir\MajorVersionUpgradeMySQLProvider.ps1 -AzureEnvironment $AzureEnvironment -AzCredential $AdminCreds -CloudAdminCredential $CloudAdminCreds -Privilegedendpoint $privilegedEndpoint -PfxPassword $PfxPass -PfxCert $PfxFilePath -MySQLConnector $MySQLConnector
Observação
O endereço DNS e o endereço IP correspondente do MySQL RP V2 são diferentes. Para obter o novo IP público, você pode entrar em contato com o suporte para exigir uma quebra de drp e encontrar o recurso MySQLRPVM1130-PublicIP. Você também pode executar "nslookup mysqlrp.dbadapter.<fqdn>" de um computador cliente que já passou no teste de ponto de extremidade para descobrir o IP público.
Validar se a atualização foi bem-sucedida
- O script MajorVersionUpgrade executado sem erros.
- Verifique o provedor de recursos no marketplace e verifique se o MySQL RP 2.0 foi instalado com êxito.
- O sistema antigo.<location.mysqladapter> grupo de recursos e sistema.<o grupo de recursos location.dbadapter.dns> na assinatura do provedor padrão não será excluído automaticamente pelo script.
- Recomendamos manter a Conta de Armazenamento e o Key Vault no grupo de recursos mysqladapter por algum tempo. Se após a atualização, qualquer usuário locatário observar metadados de logon ou banco de dados inconsistentes, será possível obter suporte para restaurar os metadados do grupo de recursos.
- Depois de verificar se a Zona DNS no grupo de recursos dbadapter.dns está vazia sem registro DNS, é seguro excluir o grupo de recursos dbadapter.dns.
- [IMPORTANTE] Não use o script de implantação V1 para desinstalar a versão V1. Após a conclusão da atualização e a confirmação de que a atualização foi bem-sucedida, você pode excluir manualmente o grupo de recursos da assinatura do provedor.
Atualização da versão anterior do MySQL RP V1 para MySQL RP V1.1.93.x
A atualização do provedor de recursos do MySQL V1 é cumulativa. Você pode atualizar diretamente para a versão 1.1.93.x.
Para atualizar o provedor de recursos para 1.1.93.x, use o scriptUpdateMySQLProvider.ps1 . Use sua conta de serviço com direitos administrativos locais e seja proprietário da assinatura. Esse script de atualização está incluído no download do provedor de recursos.
Para atualizar o provedor de recursos, use o scriptUpdateMySQLProvider.ps1 . Use sua conta de serviço com direitos administrativos locais e seja proprietário da assinatura. O script de atualização está incluído no download do provedor de recursos.
O processo de atualização é semelhante ao processo usado para Implantar o provedor de recursos. O script de atualização usa os mesmos argumentos que o script DeployMySqlProvider.ps1 e você precisará fornecer informações de certificado.
Atualizar processos de script
O scriptUpdateMySQLProvider.ps1 cria uma nova VM (máquina virtual) com a imagem mais recente do sistema operacional, implanta o código do provedor de recursos mais recente e migra as configurações do provedor de recursos antigo para o novo provedor de recursos.
Observação
Recomendamos que você baixe a imagem do Windows Server 1.2009.0 do Microsoft AzureStack Add-on rp do Marketplace Management. Se você precisar instalar uma atualização, poderá colocar um único pacote MSU no caminho de dependência local. O script falhará se houver mais de um arquivo MSU nesse local.
Depois que o scriptUpdateMySQLProvider.ps1 cria uma nova VM, o script migra as seguintes configurações da VM do provedor de recursos antigo:
- informações de banco de dados
- hospedagem de informações do servidor
- registro DNS necessário
Importante
É altamente recomendável usar Clear-AzureRmContext -Scope CurrentUser e Clear-AzureRmContext -Scope Process para limpar o cache antes de executar a implantação ou atualizar o script.
Atualizar parâmetros de script
Especifique os parâmetros a seguir da linha de comando ao executar o scriptUpdateMySQLProvider.ps1 do PowerShell. Se você não fizer isso ou se alguma validação de parâmetro falhar, será solicitado que você forneça os parâmetros necessários.
| Nome do Parâmetro | Descrição | Comentário ou valor padrão |
|---|---|---|
| CloudAdminCredential | A credencial para o administrador de nuvem, necessária para acessar o ponto de extremidade privilegiado. | Necessário |
| AzCredential | As credenciais para a conta de administrador do serviço do Azure Stack Hub. Use as mesmas credenciais usadas para implantar o Azure Stack Hub. O script falhará se a conta usada com o AzCredential exigir mfator (autenticação multifator). | Necessário |
| VMLocalCredential | As credenciais para a conta de administrador local da VM do provedor de recursos MySQL. | Necessário |
| PrivilegedEndpoint | O endereço IP ou o nome DNS do ponto de extremidade privilegiado. | Necessário |
| AzureEnvironment | O ambiente do Azure da conta de administrador de serviço usada para implantar o Azure Stack Hub. Necessário apenas para implantações de Microsoft Entra. Os nomes de ambiente com suporte são AzureCloud, AzureUSGovernment ou se estiver usando um Microsoft Entra ID da China, AzureChinaCloud. | AzureCloud |
| DependencyFilesLocalPath | O arquivo .pfx do certificado também deve ser colocado neste diretório. | Opcional (obrigatório para vários nós) |
| DefaultSSLCertificatePassword | A senha do certificado .pfx. | Necessário |
| MaxRetryCount | O número de vezes que você deseja repetir cada operação se houver uma falha. | 2 |
| RetryDuration | O intervalo de tempo limite entre repetições, em segundos. | 120 |
| Desinstalar | Remova o provedor de recursos e todos os recursos associados (confira as notas a seguir). | No |
| DebugMode | Impede a limpeza automática em caso de falha. | No |
| AcceptLicense | Ignora o prompt para aceitar a licença gpl. (https://www.gnu.org/licenses/old-licenses/gpl-2.0.html) |
Exemplo de script de atualização
Se você estiver atualizando a versão do provedor de recursos do MySQL para a versão 1.1.33.0 ou versões anteriores, precisará instalar versões específicas dos módulos AzureRm.BootStrapper e Azure Stack Hub no PowerShell.
Se você estiver atualizando o provedor de recursos do MySQL para a versão 1.1.47.0 ou posterior, poderá ignorar esta etapa. O script de implantação baixará e instalará automaticamente os módulos necessários do PowerShell para que você desmarque C:\Arquivos de Programas\SqlMySqlPsh.
Observação
Se a pasta C:\Arquivos de Programas\SqlMySqlPsh já existir com o módulo do PowerShell baixado, é recomendável limpo essa pasta antes de executar o script de atualização. Isso é para garantir que a versão certa do módulo do PowerShell seja baixada e usada.
# Run the following scripts when updating to version 1.1.33.0 only.
# Install the AzureRM.Bootstrapper module, set the profile and install the AzureStack module.
# Note that this might not be the most currently available version of Azure Stack Hub PowerShell.
Install-Module -Name AzureRm.BootStrapper -Force
Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.6.0
Observação
No cenário desconectado, você precisa baixar os módulos necessários do PowerShell e registrar o repositório manualmente como um pré-requisito. Você pode obter mais informações em Implantar provedor de recursos do MySQL
O exemplo a seguir mostra o scriptUpdateMySQLProvider.ps1 que você pode executar em um console do PowerShell com privilégios elevados. Certifique-se de alterar as informações e senhas da variável conforme necessário:
# Use the NetBIOS name for the Azure Stack Hub domain. On the Azure Stack Hub SDK, the default is AzureStack but could have been changed at install time.
$domain = "AzureStack"
# For integrated systems, use the IP address of one of the ERCS VMs.
$privilegedEndpoint = "AzS-ERCS01"
# Provide the Azure environment used for deploying Azure Stack Hub. Required only for Azure AD deployments. Supported environment names are AzureCloud, AzureUSGovernment, or AzureChinaCloud.
$AzureEnvironment = "<EnvironmentName>"
# Point to the directory where the resource provider installation files were extracted.
$tempDir = 'C:\TEMP\MYSQLRP'
# The service admin account (can be Azure Active Directory or Active Directory Federation Services).
$serviceAdmin = "admin@mydomain.onmicrosoft.com"
$AdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$AdminCreds = New-Object System.Management.Automation.PSCredential ($serviceAdmin, $AdminPass)
# Set credentials for the new resource provider VM.
$vmLocalAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$vmLocalAdminCreds = New-Object System.Management.Automation.PSCredential ("mysqlrpadmin", $vmLocalAdminPass)
# And the cloudadmin credential required for privileged endpoint access.
$CloudAdminPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
$CloudAdminCreds = New-Object System.Management.Automation.PSCredential ("$domain\cloudadmin", $CloudAdminPass)
# Change the following as appropriate.
$PfxPass = ConvertTo-SecureString 'P@ssw0rd1' -AsPlainText -Force
# For version 1.1.47.0 or later, the PowerShell modules used by the RP deployment are placed in C:\Program Files\SqlMySqlPsh
# The deployment script adds this path to the system $env:PSModulePath to ensure correct modules are used.
$rpModulePath = Join-Path -Path $env:ProgramFiles -ChildPath 'SqlMySqlPsh'
$env:PSModulePath = $env:PSModulePath + ";" + $rpModulePath
# Change directory to the folder where you extracted the installation files.
# Then adjust the endpoints.
.$tempDir\UpdateMySQLProvider.ps1 -AzCredential $AdminCreds -VMLocalCredential $vmLocalAdminCreds -CloudAdminCredential $cloudAdminCreds -PrivilegedEndpoint $privilegedEndpoint -AzureEnvironment $AzureEnvironment -DefaultSSLCertificatePassword $PfxPass -DependencyFilesLocalPath $tempDir\cert -AcceptLicense
Quando o script de atualização do provedor de recursos for concluído, feche a sessão atual do PowerShell.
Próximas etapas
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de