Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O controlador de volume Ficheiros do Azure é um plugin de volume Docker que fornece volumes baseados em Ficheiros do Azure para contentores Docker. Está embalado como uma aplicação Service Fabric que pode ser implementada num cluster Service Fabric para fornecer volumes para outras aplicações de contentores Service Fabric dentro do cluster.
Nota
A versão 6.5.661.9590 do plugin de volumes Ficheiros do Azure foi lançada para disponibilidade geral.
Prerequisites
A versão Windows do plugin de volumes Ficheiros do Azure funciona apenas em sistemas operativos Windows Server versão 1709, Windows 10 versão 1709 ou sistemas operativos posteriores.
A versão Linux do plugin de volume Ficheiros do Azure funciona em todas as versões do sistema operativo suportadas pelo Service Fabric.
O plugin de volume Ficheiros do Azure só funciona no Service Fabric versão 6.2 e versões posteriores.
Siga as instruções na documentação do Ficheiros do Azure para criar uma partilha de ficheiros para a aplicação de contentor do Service Fabric utilizar como volume.
Vai precisar do PowerShell com o módulo Service Fabric ou do SFCTL instalado.
Se estiver a usar contentores Hyper-V, os seguintes fragmentos têm de ser adicionados ao ClusterManifest (cluster local), à secção fabricSettings do seu modelo do Azure Resource Manager (cluster do Azure) ou ao ClusterConfig.json (cluster autónomo).
No ClusterManifest, o seguinte deve ser adicionado na secção de Alojamento. Neste exemplo, o nome do volume é sfazurefile e a porta que ouve no cluster é 19100. Substitua-os pelos valores corretos para o seu cluster.
<Section Name="Hosting">
<Parameter Name="VolumePluginPorts" Value="sfazurefile:19100" />
</Section>
Na secção fabricSettings do seu modelo de Azure Resource Manager (para implementações Azure) ou ClusterConfig.json (para implementações autónomas), é necessário adicionar o seguinte excerto. Mais uma vez, substitui o nome do volume e os valores de porta pelos teus próprios.
"fabricSettings": [
{
"name": "Hosting",
"parameters": [
{
"name": "VolumePluginPorts",
"value": "sfazurefile:19100"
}
]
}
]
Implantar uma aplicação de exemplo usando o controlador de volume de Service Fabric Ficheiros do Azure
Usar o Azure Resource Manager através do script PowerShell fornecido (recomendado)
Se o seu cluster estiver baseado no Azure, recomendamos implementar aplicações nele usando o modelo de recursos de aplicação do Azure Resource Manager para facilitar a utilização e ajudar a avançar para o modelo de manutenção da infraestrutura como código. Esta abordagem elimina a necessidade de acompanhar a versão da aplicação para o driver de volume do Ficheiros do Azure. Também permite manter modelos separados do Azure Resource Manager para cada sistema operativo suportado. O script assume que estás a implementar a versão mais recente da aplicação Ficheiros do Azure e toma parâmetros para o tipo de sistema operativo, ID de subscrição do cluster e grupo de recursos. Pode transferir o script do site de transferência do Service Fabric. Note que isto define automaticamente o ListenPort, que é a porta onde o plugin de volume Ficheiros do Azure ouve pedidos do daemon Docker, para 19100. Podes alterá-lo adicionando um parâmetro chamado "listenPort". Certifique-se de que a porta não entra em conflito com qualquer outra porta que o cluster ou as suas aplicações utilizem.
Comando de implementação do Azure Resource Manager para Windows:
.\DeployAzureFilesVolumeDriver.ps1 -subscriptionId [subscriptionId] -resourceGroupName [resourceGroupName] -clusterName [clusterName] -windows
Comando de implementação do Azure Resource Manager para Linux:
.\DeployAzureFilesVolumeDriver.ps1 -subscriptionId [subscriptionId] -resourceGroupName [resourceGroupName] -clusterName [clusterName] -linux
Depois de executares o script com sucesso, podes saltar para a secção de configuração da tua aplicação.
Implementação manual para clusters autónomos
A aplicação do Service Fabric que fornece os volumes para os seus contentores pode ser descarregada a partir do site de transferências do Service Fabric. A aplicação pode ser implementada no cluster através de PowerShell, CLI ou APIs FabricClient.
Usando a linha de comandos, altere o diretório para a diretório raiz do pacote de aplicação descarregado.
cd .\AzureFilesVolume\cd ~/AzureFilesVolumeDe seguida, copie o pacote de aplicação para a loja de imagens com os valores apropriados para [ApplicationPackagePath] e [ImageStoreConnectionString]:
Copy-ServiceFabricApplicationPackage -ApplicationPackagePath [ApplicationPackagePath] -ImageStoreConnectionString [ImageStoreConnectionString] -ApplicationPackagePathInImageStore AzureFilesVolumePluginsfctl cluster select --endpoint https://testcluster.westus.cloudapp.azure.com:19080 --pem test.pem --no-verify sfctl application upload --path [ApplicationPackagePath] --show-progressRegiste o tipo de candidatura
Register-ServiceFabricApplicationType -ApplicationPathInImageStore AzureFilesVolumePluginsfctl application provision --application-type-build-path [ApplicationPackagePath]Crie a aplicação, prestando muita atenção ao valor do parâmetro da aplicação ListenPort . Este valor é a porta onde o plugin de volume Ficheiros do Azure escuta pedidos do daemon Docker. Certifique-se de que a porta fornecida à aplicação corresponde às VolumePluginPorts no ClusterManifest e não entra em conflito com qualquer outra porta que o cluster ou as suas aplicações utilizem.
New-ServiceFabricApplication -ApplicationName fabric:/AzureFilesVolumePluginApp -ApplicationTypeName AzureFilesVolumePluginType -ApplicationTypeVersion 6.5.661.9590 -ApplicationParameter @{ListenPort='19100'}sfctl application create --app-name fabric:/AzureFilesVolumePluginApp --app-type AzureFilesVolumePluginType --app-version 6.5.661.9590 --parameter '{"ListenPort":"19100"}'
Nota
O Windows Server 2016 Datacenter não suporta mapear montagens SMB para contentores (Isso só é suportado no Windows Server, versão 1709). Esta restrição impede o mapeamento de volumes de rede e os drivers de volume Ficheiros do Azure em versões anteriores a 1709.
Implementar a aplicação num cluster de desenvolvimento local
Siga os passos 1 a 3 do acima.
A contagem padrão de instâncias de serviço para a aplicação do plugin de volume Ficheiros do Azure é -1, o que significa que há uma instância do serviço implementada em cada nó do cluster. No entanto, ao implementar a aplicação de plugin de volume Ficheiros do Azure num cluster de desenvolvimento local, a contagem de instâncias do serviço deve ser especificada como 1. Isto pode ser feito através do parâmetro de aplicação InstanceCount . Portanto, o comando para criar a aplicação plugin de volume Ficheiros do Azure num cluster de desenvolvimento local é:
New-ServiceFabricApplication -ApplicationName fabric:/AzureFilesVolumePluginApp -ApplicationTypeName AzureFilesVolumePluginType -ApplicationTypeVersion 6.5.661.9590 -ApplicationParameter @{ListenPort='19100';InstanceCount='1'}
sfctl application create --app-name fabric:/AzureFilesVolumePluginApp --app-type AzureFilesVolumePluginType --app-version 6.5.661.9590 --parameter '{"ListenPort": "19100","InstanceCount": "1"}'
Configure as suas aplicações para usarem o volume
O excerto seguinte mostra como um volume baseado no Ficheiros do Azure pode ser especificado no ficheiro manifesto da aplicação da sua aplicação. O elemento específico de interesse é a etiqueta Volume :
?xml version="1.0" encoding="UTF-8"?>
<ApplicationManifest ApplicationTypeName="WinNodeJsApp" ApplicationTypeVersion="1.0" xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<Description>Calculator Application</Description>
<Parameters>
<Parameter Name="ServiceInstanceCount" DefaultValue="3"></Parameter>
<Parameter Name="MyCpuShares" DefaultValue="3"></Parameter>
<Parameter Name="MyStorageVar" DefaultValue="c:\tmp"></Parameter>
</Parameters>
<ServiceManifestImport>
<ServiceManifestRef ServiceManifestName="NodeServicePackage" ServiceManifestVersion="1.0"/>
<Policies>
<ContainerHostPolicies CodePackageRef="NodeService.Code" Isolation="hyperv">
<PortBinding ContainerPort="8905" EndpointRef="Endpoint1"/>
<RepositoryCredentials PasswordEncrypted="false" Password="****" AccountName="test"/>
<Volume Source="azfiles" Destination="c:\VolumeTest\Data" Driver="sfazurefile">
<DriverOption Name="shareName" Value="" />
<DriverOption Name="storageAccountName" Value="" />
<DriverOption Name="storageAccountKey" Value="" />
<DriverOption Name="storageAccountFQDN" Value="" />
</Volume>
</ContainerHostPolicies>
</Policies>
</ServiceManifestImport>
<ServiceTemplates>
<StatelessService ServiceTypeName="StatelessNodeService" InstanceCount="5">
<SingletonPartition></SingletonPartition>
</StatelessService>
</ServiceTemplates>
</ApplicationManifest>
O nome do driver para o plugin de volume Ficheiros do Azure é sfazurefile. Este valor é definido para o atributo Driver do elemento da etiqueta Volume no manifesto da aplicação.
Na etiqueta Volume no excerto acima, o plugin Ficheiros do Azure volume requer os seguintes atributos:
- Fonte - Este é o nome do volume. O utilizador pode escolher qualquer nome para o seu volume.
- Destino - Este atributo é o local para onde o volume é mapeado dentro do contentor em execução. Assim, o seu destino não pode ser um local que já existe dentro do seu contentor
Como mostrado nos elementos DriverOption no excerto acima, o plugin de volume Ficheiros do Azure suporta as seguintes opções de driver:
shareName - Nome da partilha de ficheiros do Ficheiros do Azure que fornece o volume para o contentor.
storageAccountName - Nome da conta de armazenamento Azure que contém a Ficheiros do Azure partilha de ficheiros.
storageAccountKey - Chave de acesso para a conta de armazenamento Azure que contém a partilha de ficheiros Ficheiros do Azure.
storageAccountFQDN - Nome de domínio associado à conta de armazenamento. Se storageAccountFQDN não for especificado, o nome de domínio será formado usando o sufixo predefinido (.file.core.windows.net) juntamente com storageAccountName.
- Example1: <DriverOption Name="shareName" Value="myshare1" /> <DriverOption Name="storageAccountName" Value="myaccount1" /> <DriverOption Name="storageAccountKey" Value="mykey1" /> <!-- storageAccountFQDN will be "myaccount1.file.core.windows.net" --> - Example2: <DriverOption Name="shareName" Value="myshare2" /> <DriverOption Name="storageAccountName" Value="myaccount2" /> <DriverOption Name="storageAccountKey" Value="mykey2" /> <DriverOption Name="storageAccountFQDN" Value="myaccount2.file.core.chinacloudapi.cn" />
Utilizar o seu próprio controlador de volume ou controlador de registo
O Service Fabric também permite a utilização dos seus próprios drivers personalizados de volume ou de registo. Se o driver de volume/registo Docker não estiver instalado no cluster, pode instalá-lo manualmente usando os protocolos RDP/SSH. Pode realizar a instalação com estes protocolos através de um script de arranque de conjunto de escalas de máquina virtual ou de um script SetupEntryPoint.
Um exemplo do script para instalar o driver de volume Docker para Azure é o seguinte:
docker plugin install --alias azure --grant-all-permissions docker4x/cloudstor:17.09.0-ce-azure1 \
CLOUD_PLATFORM=AZURE \
AZURE_STORAGE_ACCOUNT="[MY-STORAGE-ACCOUNT-NAME]" \
AZURE_STORAGE_ACCOUNT_KEY="[MY-STORAGE-ACCOUNT-KEY]" \
DEBUG=1
Nas suas aplicações, para usar o controlador de volume ou de registo que instalou, terá de especificar os valores apropriados nos elementos Volume e LogConfig em ContainerHostPolicies no manifesto da sua aplicação.
<ContainerHostPolicies CodePackageRef="NodeService.Code" Isolation="hyperv">
<PortBinding ContainerPort="8905" EndpointRef="Endpoint1"/>
<RepositoryCredentials PasswordEncrypted="false" Password="****" AccountName="test"/>
<LogConfig Driver="[YOUR_LOG_DRIVER]" >
<DriverOption Name="test" Value="vale"/>
</LogConfig>
<Volume Source="c:\workspace" Destination="c:\testmountlocation1" IsReadOnly="false"></Volume>
<Volume Source="[MyStorageVar]" Destination="c:\testmountlocation2" IsReadOnly="true"> </Volume>
<Volume Source="myvolume1" Destination="c:\testmountlocation2" Driver="[YOUR_VOLUME_DRIVER]" IsReadOnly="true">
<DriverOption Name="[name]" Value="[value]"/>
</Volume>
</ContainerHostPolicies>
Ao especificar um plug-in de volume, o Service Fabric cria automaticamente o volume usando os parâmetros especificados. A etiqueta Source para o elemento Volume é o nome do volume e a tag Driver especifica o plug-in do controlador de volume. A etiqueta Destino indica a localização para onde a Origem é mapeada dentro do contentor em execução. Assim, o seu destino não pode ser um local que já existe dentro do seu contentor. As opções podem ser especificadas usando a etiqueta DriverOption da seguinte forma:
<Volume Source="myvolume1" Destination="c:\testmountlocation4" Driver="azure" IsReadOnly="true">
<DriverOption Name="share" Value="models"/>
</Volume>
Os parâmetros da aplicação são suportados em volumes, conforme mostrado no excerto do manifesto apresentado anteriormente (procure MyStorageVar para ver um exemplo de utilização).
Se for especificado um driver de log Docker, tens de implementar agentes (ou containers) para gerir os logs no cluster. A etiqueta DriverOption pode ser usada para especificar opções para o driver de log.
Passos seguintes
- Para ver exemplos de contentores, incluindo o controlador de volumes, visite os exemplos de contentores do Service Fabric
- Para implantar contentores num cluster de Fabric de Serviços, consulte o artigo Implante um contentor em Service Fabric