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

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?

• Quero saber mais sobre os arquivos ServiceDefinition.csdef e ServiceConfig.cscfg.
• Já sei sobre isso, dê-me alguns exemplos sobre o que posso configurar.
• Quero criar o ServicePackage.cspkg.
• Estou usando o Visual Studio e quero...
  • Criar um serviço de nuvem
  • Reconfigurar um serviço de nuvem existente
  • Implantar um projeto do serviço de nuvem
  • Área de trabalho remota em uma instância de serviço de nuvem

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.

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.

ServicePackage.cspkg

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\

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:

Próximas etapas

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

• Configurar área de trabalho remota para uma instância de serviço de nuvem
• Implantar um projeto do serviço de nuvem

Estou usando o Visual Studio e quero...

• Criar um novo serviço de nuvem
• Reconfigurar um serviço de nuvem existente
• Implantar um projeto do serviço de nuvem
• Configurar área de trabalho remota para uma instância de serviço de nuvem