Compartilhar via

Qual é o modelo de Serviço de Nuvem (clássico) e como empacotá-lo?

  • Artigo

Importante

Os Serviços de Nuvem (clássico) agora serão preteridos para todos os clientes a partir de 1º de setembro de 2024. Todas as implantações em execução existentes serão interrompidas e desligadas pela Microsoft e os dados serão permanentemente perdidos. As novas implantações devem usar o novo modelo de implantação baseado no Azure Resource Manager Serviços de Nuvem do Azure (suporte estendido) .

Um serviço de nuvem é criado a partir de três componentes, a definição do serviço (.csdef), configuração do serviço (.cscfg) e pacote do serviço (.cspkg). Os arquivos ServiceDefinition.csdef e ServiceConfig.cscfg são baseados no XML, descrevem a estrutura do serviço de nuvem e sua configuração; coletivamente são chamados de modelo. O ServicePackage.cspkg é um arquivo zip gerado do ServiceDefinition.csdef e entre outras coisas, contém todas as dependências necessárias com base no binário. O Azure cria um serviço de nuvem para o ServicePackage.cspkg e o ServiceConfig.cscfg.

Quando o serviço de nuvem estiver em execução no Azure, você poderá reconfigurá-lo por meio do arquivo ServiceConfig.cscfg, mas você não pode alterar a definição.

O que você deseja saber mais?

ServiceDefinition.csdef

O arquivo ServiceDefinition.csdef especifica as configurações que são usadas pelo Azure para configurar um serviço de nuvem. O esquema de definição de serviço do Azure (arquivo .csdef) fornece o formato permitido para um arquivo de definição de serviço. O exemplo a seguir mostra as configurações que podem ser definidas para as funções da Web e de trabalho:

<?xml version="1.0" encoding="utf-8"?>
<ServiceDefinition name="MyServiceName" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition">
  <WebRole name="WebRole1" vmsize="Medium">
    <Sites>
      <Site name="Web">
        <Bindings>
          <Binding name="HttpIn" endpointName="HttpIn" />
        </Bindings>
      </Site>
    </Sites>
    <Endpoints>
      <InputEndpoint name="HttpIn" protocol="http" port="80" />
      <InternalEndpoint name="InternalHttpIn" protocol="http" />
    </Endpoints>
    <Certificates>
      <Certificate name="Certificate1" storeLocation="LocalMachine" storeName="My" />
    </Certificates>
    <Imports>
      <Import moduleName="Connect" />
      <Import moduleName="Diagnostics" />
      <Import moduleName="RemoteAccess" />
      <Import moduleName="RemoteForwarder" />
    </Imports>
    <LocalResources>
      <LocalStorage name="localStoreOne" sizeInMB="10" />
      <LocalStorage name="localStoreTwo" sizeInMB="10" cleanOnRoleRecycle="false" />
    </LocalResources>
    <Startup>
      <Task commandLine="Startup.cmd" executionContext="limited" taskType="simple" />
    </Startup>
  </WebRole>

  <WorkerRole name="WorkerRole1">
    <ConfigurationSettings>
      <Setting name="DiagnosticsConnectionString" />
    </ConfigurationSettings>
    <Imports>
      <Import moduleName="RemoteAccess" />
      <Import moduleName="RemoteForwarder" />
    </Imports>
    <Endpoints>
      <InputEndpoint name="Endpoint1" protocol="tcp" port="10000" />
      <InternalEndpoint name="Endpoint2" protocol="tcp" />
    </Endpoints>
  </WorkerRole>
</ServiceDefinition>

Você pode consultar o Esquema de Definição de Serviço para entender melhor o esquema XML usado aqui; no entanto, veja a seguir uma explicação rápida de alguns dos elementos:

Sites
contêm as definições para sites da Web ou aplicativos Web hospedados no IIS7.

InputEndpoints
contém as definições para pontos de extremidade usados para entrar em contato com o serviço de nuvem.

InternalEndpoints
contém as definições para pontos de extremidade que são usados por instâncias de função para se comunicar entre si.

ConfigurationSettings
contém as definições de configuração para recursos de uma função específica.

Certificados
contêm as definições para certificados que são necessárias para uma função. O exemplo de código anterior mostra um certificado que é usado para a configuração do Azure Connect.

LocalResources
contém as definições para recursos de armazenamento local. Um recurso de armazenamento local é um diretório reservado no sistema de arquivos da máquina virtual no qual uma instância de uma função está em execução.

Imports
contém as definições para módulos importados. O exemplo de código anterior mostra os módulos para conexão de área de trabalho remota e Azure Connect.

Inicialização
contém tarefas que são executadas quando a função é iniciada. As tarefas são definidas em um arquivo executável ou o .cmd.

ServiceConfiguration.cscfg

A definição das configurações do serviço de nuvem é determinada pelos valores do arquivo ServiceConfiguration.cscfg . Especifique o número de instâncias que você deseja implantar para cada função nesse arquivo. Os valores para os parâmetros de configuração que você definiu no arquivo de definição de serviço são adicionados ao arquivo de configuração de serviço. As impressões digitais para qualquer certificado de gerenciamento que estão associadas ao serviço de nuvem também são adicionadas ao arquivo. O esquema de configuração de serviço do Azure (arquivo .cscfg) fornece o formato permitido para um arquivo de configuração de serviço.

O arquivo de configuração de serviço não é empacotado com o aplicativo. A configuração é carregada no Azure como um arquivo separado e usada para configurar o serviço de nuvem. Você pode carregar um novo arquivo de configuração de serviço sem reimplantar o serviço de nuvem. Os valores de configuração do serviço de nuvem podem ser alterados enquanto o serviço de nuvem está em execução. O exemplo a seguir mostra as definições de configuração que podem ser definidas para as funções da Web e de trabalho:

<?xml version="1.0"?>
<ServiceConfiguration serviceName="MyServiceName" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration">
  <Role name="WebRole1">
    <Instances count="2" />
    <ConfigurationSettings>
      <Setting name="SettingName" value="SettingValue" />
    </ConfigurationSettings>

    <Certificates>
      <Certificate name="CertificateName" thumbprint="CertThumbprint" thumbprintAlgorithm="sha1" />
      <Certificate name="Microsoft.WindowsAzure.Plugins.RemoteAccess.PasswordEncryption"
         thumbprint="CertThumbprint" thumbprintAlgorithm="sha1" />
    </Certificates>
  </Role>
</ServiceConfiguration>

Você pode consultar o Esquema de Configuração de Serviço para entender melhor o esquema XML usado aqui; no entanto, veja a seguir uma explicação rápida dos elementos:

Instâncias
configura o número de instâncias em execução para a função. Para impedir que seu serviço de nuvem fique indisponível durante atualizações, recomendamos implantar mais de uma instância de suas funções da Web. Ao implantar mais de uma instância, você estará aderindo às diretrizes do Contrato de Nível de Serviço (SLA) de Computação do Azure , que garante 99,95% de conectividade externa para funções de Internet quando duas ou mais instâncias de função são implantadas para um serviço.

ConfigurationSettings
define as configurações para as instâncias em execução para uma função. O nome dos <Setting> elementos deve corresponder às definições no arquivo de definição de serviço.

Certificados
configura os certificados que são usados pelo serviço. O exemplo de código anterior mostra como definir o certificado para o módulo RemoteAccess. O valor do atributo impressão digital deve ser definido como a impressão digital do certificado que será usado.

Observação

A impressão digital do certificado pode ser adicionada ao arquivo de configuração usando um editor de texto. Ou então, o valor pode ser adicionado na guia Certificados da página Propriedades da função no Visual Studio.

Definindo as portas para instâncias de função

O Azure permite apenas um ponto de entrada para uma função web. Isso significa que todo o tráfego ocorre por meio de um endereço IP. Você pode configurar seus sites para compartilhar uma porta ao configurar o cabeçalho do host para direcionar a solicitação para o local correto. Você também pode configurar seus aplicativos para escutar portas conhecidas no endereço IP.

O exemplo a seguir mostra a configuração de uma função web com um site e o aplicativo Web. O site é configurado como o local de entrada padrão na porta 80. Os aplicativos Web são configurados para receber solicitações de um cabeçalho de host alternativo que é chamado “mail.mysite.cloudapp.net”.

<WebRole>
  <ConfigurationSettings>
    <Setting name="DiagnosticsConnectionString" />
  </ConfigurationSettings>
  <Endpoints>
    <InputEndpoint name="HttpIn" protocol="http" port="80" />
    <InputEndpoint name="Https" protocol="https" port="443" certificate="SSL"/>
    <InputEndpoint name="NetTcp" protocol="tcp" port="808" certificate="SSL"/>
  </Endpoints>
  <LocalResources>
    <LocalStorage name="Sites" cleanOnRoleRecycle="true" sizeInMB="100" />
  </LocalResources>
  <Site name="Mysite" packageDir="Sites\Mysite">
    <Bindings>
      <Binding name="http" endpointName="HttpIn" />
      <Binding name="https" endpointName="Https" />
      <Binding name="tcp" endpointName="NetTcp" />
    </Bindings>
  </Site>
  <Site name="MailSite" packageDir="MailSite">
    <Bindings>
      <Binding name="mail" endpointName="HttpIn" hostHeader="mail.mysite.cloudapp.net" />
    </Bindings>
    <VirtualDirectory name="artifacts" />
    <VirtualApplication name="storageproxy">
      <VirtualDirectory name="packages" packageDir="Sites\storageProxy\packages"/>
    </VirtualApplication>
  </Site>
</WebRole>

Alterar a configuração de uma função

Você pode atualizar a configuração do seu serviço de nuvem enquanto ele é executado no Azure, sem que o serviço fique offline. Para alterar informações de configuração, você pode carregar um novo arquivo de configuração, ou editar o arquivo de configuração no local e aplicá-lo ao seu serviço em execução. As seguintes alterações podem ser feitas na configuração de um serviço:

  • Alterando os valores das configurações
    Quando uma configuração é alterada, uma instância de função pode optar por aplicar a alteração enquanto a instância está online ou reciclar a instância normalmente e aplicar a alteração enquanto a instância está offline.
  • Alterando a topologia de serviço das instâncias da função
    As alterações topologia não afetam as instâncias em execução, exceto quando uma instância está sendo removida. Todas as instâncias restantes geralmente não precisam ser recicladas. No entanto, você pode optar por reciclar instâncias de função em resposta a uma alteração de topologia.
  • Alterando a impressão digital do certificado
    Somente é possível atualizar um certificado quando uma instância de função está offline. Se um certificado for adicionado, excluído ou alterado enquanto uma instância de função estiver online, o Azure normalmente colocará a instância offline para atualizar o certificado. O Azure a coloca online novamente após a conclusão da alteração.

Tratando alterações de configuração com eventos de runtime do serviço

A Biblioteca de Tempo de Execução do Azure inclui o namespace Microsoft.WindowsAzure.ServiceRuntime, que fornece classes para interagir com o ambiente do Azure de uma função. A classe RoleEnvironment define os seguintes eventos que são disparados antes e depois de uma alteração de configuração:

  • Alterando eventos
    Isso ocorre antes que a alteração de configuração seja aplicada a uma instância específica de uma função, fornecendo a oportunidade de desativar as instâncias de função, se necessário.
  • Evento alterado
    Ocorre depois que a alteração de configuração é aplicada a uma instância específica de uma função.

Observação

Como as alterações de certificado sempre tornam as instâncias de uma função offline, elas não geram os eventos RoleEnvironment.Changing ou RoleEnvironment.Changed.

ServicePackage.cspkg

Observação

O tamanho máximo do pacote que pode ser implantado é 600 MB

Para implantar um aplicativo como um serviço de nuvem no Azure, primeiro você deve empacotar o aplicativo no formato apropriado. Você pode usar a ferramenta de linha de comando CSPack (instalada com o SDK do Azure) para criar o arquivo de pacote como uma alternativa para o Visual Studio.

CSPack usa o conteúdo do arquivo de definição de serviço e arquivo de configuração de serviço para definir o conteúdo do pacote. CSPack gera um arquivo de pacote de aplicativos (.cspkg) que você pode carregar no Azure usando o Portal do Azure. Por padrão, o pacote é denominado [ServiceDefinitionFileName].cspkg, mas você pode especificar um nome diferente usando a opção /out de CSPack.

CSPack está localizado em
C:\Program Files\Microsoft SDKs\Azure\.NET SDK\[sdk-version]\bin\

Observação

O CSPack.exe (no Windows) está disponível executando o atalho do prompt de comando do Microsoft Azure que é instalado com o SDK.

Execute o programa CSPack.exe por ele mesmo para ver a documentação sobre todos os comandos e opções possíveis.

Dica

Para executar o serviço de nuvem localmente no Emulador de Computação do Microsoft Azure, use a opção /copyonly. Esta opção copia os arquivos binários do aplicativo para um layout de diretório do qual eles podem ser executados no emulador de computação.

Exemplo de comando para empacotar um serviço de nuvem

O exemplo a seguir cria um pacote de aplicativos que contém as informações para uma função web. O comando especifica o arquivo de definição de serviço para usar, o diretório onde os arquivos binários podem ser encontrados e o nome do arquivo do pacote.

cspack [DirectoryName]\[ServiceDefinition]
       /role:[RoleName];[RoleBinariesDirectory]
       /sites:[RoleName];[VirtualPath];[PhysicalPath]
       /out:[OutputFileName]

Se o aplicativo contém uma função web e uma função de trabalho, o comando a seguir será usado:

cspack [DirectoryName]\[ServiceDefinition]
       /out:[OutputFileName]
       /role:[RoleName];[RoleBinariesDirectory]
       /sites:[RoleName];[VirtualPath];[PhysicalPath]
       /role:[RoleName];[RoleBinariesDirectory];[RoleAssemblyName]

Onde as variáveis são definidas da seguinte maneira:

Variável Valor
[DirectoryName] O subdiretório no diretório do projeto raiz que contém o arquivo .csdef do projeto do Azure.
[ServiceDefinition] O nome do arquivo de definição de serviço. Por padrão, esse arquivo é chamado de ServiceDefinition.csdef.
[OutputFileName] O nome do arquivo de pacote gerado. Normalmente, essa variável é definida como o nome do aplicativo. Se nenhum nome de arquivo for especificado, o pacote de aplicativos é criado como [ApplicationName].cspkg.
[RoleName] O nome da função, conforme definido no arquivo de definição de serviço.
[RoleBinariesDirectory] O local dos arquivos binários da função.
[VirtualPath] Os diretórios físicos para cada caminho virtual definido na seção Sites da definição de serviço.
[PhysicalPath] Os diretórios físicos do conteúdo de cada caminho virtual definido no nó de site da definição de serviço.
[RoleAssemblyName] O nome do arquivo binário para a função.

Próximas etapas

Estou criando um pacote de serviço de nuvem e desejo...

Estou usando o Visual Studio e quero...