Compartilhar via


hpcsync

Copia pacotes OPC de uma conta de armazenamento do Windows Azure e os descompacta em um nó do Windows Azure.

Observação

Esse comando foi introduzido no HPC Pack 2008 R2 com Service Pack 1 e não tem suporte em versões anteriores.

Sintaxe

hpcsync [<storageAccountName> <storageKey>] [<packageRoot>] [/packageName:<packageNameFilter>]   
[/container:<Container name>] [/blocksize:<blockSize>] [/usehttp]   
  
hpcsync {/? | /help}  

Parâmetros

Em alguns casos, um administrador de cluster pode executar clusrun hpcsync sem especificar parâmetros para o comando hpcsync.

Parâmetro Descrição
< > storageAccountName Especifica o nome público da conta de armazenamento do Windows Azure (o mesmo nome de armazenamento especificado no modelo de nó do Windows Azure).

Esse é o valor de <> storageAccountName na URL pública da conta: https://<storageAccountName>.blob.core.windows.net.

Se você especificar <storageAccountName>, também deverá especificar <storageKey>Observação: Se um administrador de cluster executar o comando clusrun hpcsync, o nome da conta de armazenamento e a chave não precisarão ser especificados. Os valores são fornecidos pela variável de ambiente CCP_AZURE_CONNECTIONSTRING (que é definida no nível do processo para clustersrun somente trabalhos). Se um administrador de cluster executar hpcsync sem de cluster ou se um usuário de cluster executar hpcsync, as informações da conta de armazenamento deverão ser fornecidas nos parâmetros de comando.
< > storageKey Especifica a chave de acesso para a conta de armazenamento do Windows Azure.

Se você especificar <>storageKey, também deverá especificar <storageAccountName>. Observação: Se um administrador de cluster executar o comando clusrun hpcsync, o nome da conta de armazenamento e a chave não precisarão ser especificados. Os valores são fornecidos pela variável de ambiente CCP_AZURE_CONNECTIONSTRING (que é definida no nível do processo somente para trabalhos de cluster). Se um administrador de cluster executar hpcsync sem de cluster ou se um usuário de cluster executar hpcsync, as informações da conta de armazenamento deverão ser fornecidas nos parâmetros de comando.
< > packageRoot Especifica o diretório raiz de destino para implantar os pacotes.

O valor padrão quando um administrador de cluster executa o comando é %CCP_PACKAGE_ROOT%. O valor padrão de um usuário de cluster é seu diretório de usuário, %USERPROFILE%\Packages.

Para que os serviços SOA e XLLs funcionem corretamente, o diretório raiz deve ser o valor padrão (%CCP_PACKAGE_ROOT% ou %USERPROFILE%\Packages).

A variável de ambiente %CCP_PACKAGE_ROOT% aponta para um local gerenciado pelo Windows Azure. O HPC Pack usa as APIs do Windows Azure para definir um valor para essa variável depois que os nós do Windows Azure tiverem sido implantados. O valor de %CCP_PACKAGE_ROOT% é consistente em uma implantação do Windows Azure, mas pode variar entre implantações. Observação: Ao carregar um pacote em uma conta de armazenamento (usando de upload do hpcpack), você pode definir o atributo de caminho relativo. Se o pacote especificar um caminho relativo, o pacote será implantado para <>packageRoot \<> relativePath - por exemplo, %CCP_PACKAGE_ROOT%\myDir.
/packageName Especifica o pacote que você deseja baixar. Se você não especificar esse parâmetro, todos os pacotes OPC serão baixados.
/recipiente Especifica o nome do contêiner na conta de armazenamento do Windows Azure da qual você deseja baixar o arquivo. Se você não especificar esse parâmetro, os pacotes serão baixados do local padrão: um contêiner chamado hpcpackages na conta de armazenamento.
/blocksize Especifica o tamanho do bloco, em bytes, em que o arquivo será separado ao baixar. O tamanho do bloco padrão é de 4 MB (4194304 bytes). 4 MB também é o tamanho máximo do bloco. Talvez você queira especificar um tamanho de bloco menor se estiver enfrentando uma conexão de rede instável.
/usehttp Especifica que você deseja substituir o canal https padrão pela porta 443 e tentar a comunicação usando http pela porta 80. Se isso falhar, ele será revertido para a porta 443. Observação: Esse parâmetro foi introduzido no HPC Pack 2008 R2 com Service Pack 3 e não tem suporte em versões anteriores.
/? Exibe a Ajuda no prompt de comando.
/Ajuda Exibe a Ajuda no prompt de comando.

Comentários

  • hpcsync está disponível em recursos de computação do Windows Azure que são ingressados em um cluster local que esteja executando pelo menos o Microsoft HPC Pack 2008 R2 com SP1 ou recursos de computação do Windows Azure que fazem parte de uma implantação do Windows Azure HPC Scheduler.

  • hpcsync é executado automaticamente quando você inicia nós do Windows Azure no HPC Cluster Manager e também é executado automaticamente se qualquer uma das instâncias de nó for reprovisionada como parte da manutenção do Windows Azure. Esse mecanismo ajuda a garantir que os arquivos necessários estejam disponíveis nos nós na inicialização ou se as instâncias de nós forem reprovisionadas. O hpcsync chamadas na execução de provisionamento de nó sem parâmetros. Isso significa que os pacotes são copiados do local padrão no armazenamento para o local padrão nos nós. Para obter mais informações, consulte Aproveitando chamadas hpcsync automáticas para implantação de aplicativos posteriormente neste tópico.

  • Como ele é executado automaticamente durante a intermitência para implantações do Windows Azure, você não precisa necessariamente executar hpcsync diretamente. No entanto, se você preparar pacotes para armazenamento depois que os nós do Windows Azure já estiverem implantados ou se você estiver implantando pacotes em uma implantação do Agendador de HPC do Windows Azure, poderá executar manualmente hpcsync com clusrun. hpcsync também fornece alguns parâmetros para copiar pacotes de contêineres de armazenamento diferentes e implantar os pacotes em diretórios de destino alternativos.

  • hpcsync é ideal para implantar serviços SOA, arquivos XLL e scripts de inicialização do armazenamento do Windows Azure para seus locais esperados em seus nós do Windows Azure. Como alternativa, você pode usar os comandos hpcpack ( de carregamento hpcpack e de download do hpcpack) para mover outros tipos de arquivos, aplicativos ou dados de trabalho entre o armazenamento do Windows Azure e seus nós do Windows Azure. Para obter mais informações, consulte hpcpack.

  • Para usar esse comando, os usuários do cluster devem saber o nome da conta de armazenamento e a chave de acesso primária.

Exemplos

Para um administrador de cluster implantar todos os arquivos OPC do contêiner padrão em uma conta de armazenamento do Windows Azure em um conjunto de nós de trabalho do Windows Azure:

clusrun /nodegroup:AzureWorkerNodes hpcSync

Para um usuário de cluster implantar todos os arquivos OPC de um contêiner específico em uma conta de armazenamento do Windows Azure (myContainer) em seu diretório padrão em um conjunto de nós do Windows Azure (nós 1-3):

job submit /requestednodes:node1,node2,node3 hpcSync myAccount myKey /container:myContainer

Para ajudar a solucionar problemas de implantação de arquivos, você pode testar o comando tentando implantar os arquivos no computador local em C:\temp:

hpcsync myAccount myKey C:\temp

Aproveitando chamadas hpcsync automáticas para implantação de aplicativo

Para aproveitar as chamadas de hpcsync automáticas durante o provisionamento de nó, você deve preparar pacotes OPC para o hpcpackages contêiner na conta de armazenamento do Windows Azure antes de implantar seus nós. Você pode usar os comandos hpcpack para empacotar e carregar arquivos no armazenamento do Windows Azure. (Por padrão, hpcpack upload coloca pacotes no hpcpackages contêiner; especifique um contêiner alternativo se não quiser que os pacotes sejam implantados automaticamente em todos os nós do Windows Azure.)

Por padrão, para administradores de cluster hpcsync implanta arquivos em um local nos nós do Windows Azure que é determinado em parte pela variável de ambiente %CCP_PACKAGE_ROOT%. Essa variável é definida em nós do Windows Azure durante o processo de provisionamento. Os arquivos extraídos são colocados em uma pasta determinada da seguinte maneira: %CCP_PACKAGE_ROOT%\<packageName>\<uploadTimeStamp>. Esse é o local esperado para serviços SOA, XLLs, pastas de trabalho do Excel e scripts de inicialização chamados do modelo de nó. No entanto, isso não é conveniente para aplicativos que os usuários do cluster chamarão em suas linhas de comando.

Para simplificar a estrutura de pastas para arquivos executáveis, você pode definir a propriedade de caminho relativo para o pacote quando carregá-la no armazenamento. hpcsync aplica o caminho relativo ao extrair os arquivos, de modo que o caminho seja determinado da seguinte maneira: %CCP_PACKAGE_ROOT%\<relativePath>. Os usuários podem especificar o caminho para seu aplicativo, como no seguinte exemplo de um comando de envio de trabalho: envio de trabalho %CCP_PACKAGE_ROOT%\myRelativePath\myapp.exe

Para obter mais informações, consulte Implantando aplicativos em nós do Windows Azure em um cluster do Windows HPC.

Considerações importantes sobre %CCP_PACKAGE_ROOT%

  • Nos nós do Windows Azure, a pasta %CCP_PACKAGE_ROOT% é criada em uma partição de disco de 10 GB. Isso significa que todos os arquivos de aplicativo em uma instância de nó não podem exceder 10 GB. Se um aplicativo tiver arquivos de entrada e saída consideráveis, você poderá usar um script de inicialização para conceder permissões de usuário nas unidades C:\ para que os usuários possam gravar em todo o espaço disponível no nó.

  • Ao executar hpcsync manualmente, você pode substituir o de local padrão (%CCP_PACKAGE_ROOT%). Por exemplo, você pode criar uma pasta em cada nó do Windows Azure e especificar esse local quando executar hpcsync. Todos os pacotes serão extraídos para essa pasta. No entanto, quaisquer novas instâncias de nó implantadas (ou reprovisionadas automaticamente) não incluirão essa pasta e os pacotes serão implantados automaticamente no local padrão.

  • Os usuários do cluster só têm permissões de gravação em pastas no %CCP_PACKAGE_ROOT%. A menos que você modifique as permissões de pasta nos nós do Windows Azure, somente os administradores de cluster podem executar aplicativos fora de %CCP_PACKAGE_ROOT%.

  • Quando hpcsync implanta um pacote, nenhum dos arquivos extraídos pode ter um caminho completo com mais de 256 caracteres. Os diretórios raiz em que os arquivos extraídos são temporariamente e, finalmente, colocados, podem levar até 136 caracteres, deixando 120 caracteres para o nome do arquivo, subdiretórios (se houver) e o relativePath (se especificado). Se o caminho dos arquivos extraídos exceder 256 caracteres, a implantação do pacote falhará.

Consulte também

hpcpack
clusrun
intermitência para instâncias de trabalho do Azure com o Microsoft HPC Pack