Introdução ao Service Bus para Windows Server 1.1

Publicado: setembro de 2016

Aplicável a: Service Bus for Windows Server 1.1

Esta seção descreve como instalar o Barramento de Serviço para o Windows Server localmente e definir as opções de configuração. Quando o Barramento de Serviço para o Windows Server estiver em execução, você poderá seguir um tutorial que mostra como criar uma fila, bem como algumas operações básicas do sistema de mensagens. Para começar a desenvolver um aplicativo, consulte Tutorial: First Application.

Instalar o Barramento de Serviço para o Windows Server

Essa seção descreve as etapas básicas necessárias para configurar o Barramento de Serviço para o Windows Server. Observe os seguintes pré-requisitos:

• Todas as instâncias de SQL são posicionadas em um SQL Server local.

• O serviço do Navegador SQL deve estar ativado e em execução.

• TCP/IP deve estar ativado. Isso inclui desativar o firewall em uma porta específica e ativar os serviços do Navegador SQL.

• Caso tenha uma versão anterior do Barramento de Serviço para o Windows Server instalada, consulte Atualizando o Service Bus de Versões Anteriores.

• Caso tenha instalado anteriormente o Service Bus, certifique-se de que os seguintes bancos de dados tenham sido excluídos: SBGatewayDatabase; SBManagementDB; ServiceBusDefaultContainer.

• Os serviços são executados com as credenciais de usuário atuais.

• O script de instalação requer uma conta de domínio.

• O Service Bus usa um certificado gerado automaticamente.

Instalar o Service Bus

Primeiro, verifique se desinstalou todos os serviços do winfab, bem como o Service Bus. A seguir, faça o seguinte:

Usar um feed público de Web Platform Installer

1. Instale o Microsoft Web Platform Installer 4.6 aqui.

2. Inicie o Web Platform Installer. Em Produtos, clique em Windows Azure e busque Windows Azure Service Bus 1.1.

   

Configurar o Barramento de Serviço para o Windows Server

Configurar o Service Bus usando o Assistente de Configuração

As etapas necessárias para configurar um farm de Barramento de Serviço para o Windows Server 1.1 são parecidas com aquelas especificadas aqui.

Quando o Web Platform Installer for concluído, é possível iniciar o assistente de configuração do Service Bus. Siga o procedimento a seguir:

1. No menu Iniciar, clique em Todos os Programas. Em seguida, clique em Service Bus 1.1. Clique em Configuração do Service Bus para iniciar o assistente de configuração do Service Bus.

   

   O assistente de configuração o guiará na configuração de um novo farm do Service Bus (cluster de servidores), no ingresso a um farm existente ou na saída do farm no qual já ingressou. Este tutorial de introdução mostra detalhadamente o processo de criação de farm, com configurações padrão.

   O assistente de configuração do Service Bus usa os cmdlets do PowerShell do Service Bus para todas as operações. Você pode usar o assistente para definir as suas propriedades do farm e, em seguida, exportar o script cmdlet gerado para uso futuro. Não é possível usar o assistente para modificar configurações ou para realizar operações após a criação do farm.

2. Clique em Usando as Configurações Padrão (Recomendado). A caixa de diálogo Nova configuração de farm é exibida.

   

3. Na caixa de texto INSTÂNCIA DO SQL SERVER, o nome da instância do SQL Server no computador atual é exibido por padrão. Para especificar um SQL Server diferente, insira o nome completo da instância do SQL Server que irá hospedar os bancos de dados do farm. Para verificar se o nome da instância inserido corresponde a uma instância válida, clique em Testar conexão. Se a conexão for realizada corretamente, um ícone de marca de seleção verde será exibido ao lado do botão. Caso ocorra um erro, uma mensagem será exibida no assistente.

4. Em Configurar conta de serviço, a sua ID de usuário é exibida na caixa de texto ID DE USUÁRIO para identificar a conta de usuário sob a qual os serviços são executados. Informe a senha para a ID de usuário na caixa de texto SENHA. O assistente valida a combinação de ID de usuário e senha e, caso encontre um erro, notifica-o para inserir a ID de usuário e a senha novamente. São usadas as mesmas credenciais de usuário para todos os serviços do Service Bus.

5. Em Chave de Geração de Certificado, insira uma chave na primeira caixa de texto e, em seguida, insira a mesma chave na caixa de texto em CONFIRMAR CHAVE DE GERAÇÃO DE CERTIFICADO para confirmar a primeira chave inserida. Grave a chave para uso futuro; ela será necessária sempre que você adicionar um computador a este farm. Os cmdlets de configuração usam essa chave para a geração de certificados. Você pode especificar um certificado personalizado com as opções de configuração personalizadas.

6. A caixa de seleção Habilitar regras do firewall neste computador permite que você indique se deseja que o assistente de configuração crie ou não regras de firewall. Desmarque essa caixa apenas se os clientes do Service Bus (seu aplicativo) serão executados no mesmo servidor que o Service Bus.

7. Caso deseje que o farm do Service Bus seja gerenciado no portal Windows Azure Pack, clique em Gerenciar este farm com o Portal de Gerenciamento do Service Bus.

8. Defina o nome de usuário/senha (sem usuário ingressado no domínio) para que o portal se comunique com o Service Bus. Observe que é necessário fornecer dois conjuntos diferentes.

   

   Dica

   O assistente de configuração permite especificar os parâmetros que são necessários para que o site do Windows Azure Pack se conecte com o Service Bus. Caso planeje conectar o farm do Barramento de Serviço para o Windows Server ao site do Windows Azure Pack, é necessário configurar dois conjuntos de nomes de usuário e senhas, que serão usados para proteger chamados de API entre o portal e o farm do Barramento de Serviço para o Windows Server.

   Dica

   A autenticação entre o Service Bus e o site do Windows Azure Pack não é baseada na autenticação do Windows. Portanto, ao inserir nomes de usuário e senhas, não informe usuários de domínio (tanto para o administrador quanto as APIs de locatário).

9. Clique em Próximo. O assistente exibe a tela Resumo, que lista os valores inseridos juntamente com os valores padrão das restantes opções de configuração. A tela exibe também as opções de configuração e os valores do farm inteiro e, individualmente, do Barramento de Serviço para o Windows Server 1.0. O assistente verifica também se os valores de configuração são válidos para esse computador. Em caso de erro, o assistente exibirá a página de erro e não permitirá que você prossiga. Você pode voltar para alterar a configuração que está causando o erro ou, se possível, corrigir o erro fora do assistente.

   Para alguns erros, pode não ser possível continuar com a configuração padrão. Por exemplo, se a porta padrão usada para o gerenciamento do Barramento de Serviço para o Windows Server 1.0 estiver bloqueada por um aplicativo, poderá não ser possível desbloqueá-la. Caso não seja possível continuar com a configuração padrão, você deverá criar um novo farm com as definições personalizadas.

   Observação

   Se houver erros que possam ser consertados fora do assistente, você pode usar o botão revalidar para validar a configuração novamente.

   Observação

   Se deseja configurar o Barramento de Serviço para o Windows Server usando o PowerShell, é possível gerar um script baseado na configuração atual com esta página ao clicar em Obter comandos PowerShell.

10. Clique em Aplicar para aprovar as opções listadas, criar o novo farm e adicionar o servidor ao novo farm. Clique em Voltar para retornar para a página Nova configuração de farm e alterar as entradas.

Configurar o Service Bus no site de administrador do Windows Azure Pack

Quando um farm Barramento de Serviço para o Windows Server estiver configurado, é possível conectá-lo a um site de gerenciamento do Windows Azure Pack para possibilitar que administradores e locatários usem o Barramento de Serviço para o Windows Server através do site de locatário do Windows Azure Pack.

É possível começar a configurar o site de administrador do Windows Azure Pack ou instalá-lo depois de configurar o farm Barramento de Serviço para o Windows Server.

1. Instalar e configurar o site de administrador do Windows Azure Pack. Consulte o guia de implantação do Windows Azure Pack aqui.

2. Navegue até o Portal de Gerenciamento de Serviços do Windows Azure Pack. Clique em Novo, em seguida, em Nuvens do Service Bus e Conectar a.

   

3. Forneça um nome único e amigável com que a nuvem do Service Bus será identificada no site do Windows Azure Pack.

4. Informe o ponto de extremidade de fornecimento de recursos do seu farm. Ele deve ser parecido com isso:

   https://<ServiceBusFQDN>:9359  
   

5. Insira o nome de usuário e senha do administrador e locatário que foram fornecidos no momento de criação do farm (no cmdlet do new-sbFarm ou dentro do assistente de configuração do Barramento de Serviço para o Windows Server).

6. Quando o farm Barramento de Serviço para o Windows Server tiver sido autenticado com sucesso, será possível visualizar a nuvem de Barramento de Serviço para o Windows Server recém-criada no site do Windows Azure Pack.

   

Provisionar um namespace do Service Bus usando o site do Windows Azure Pack

Crie um plano que inclua o Service Bus no site de administrador do Windows Azure Pack. Faça o seguinte:

1. No portal de administrador do Windows Azure Pack, clique em Planos e, em seguida, em Criar Plano.

   

2. Habilite o Service Bus no plano recém-criado. Selecione a nuvem do Service Bus que será oferecida como parte do plano.

   

3. Defina o plano como público para que um locatário possa utilizá-lo. Ou definia um código de convite.

   

4. Certifique-se de definir o plano para permitir assinaturas ilimitadas.

   

Configurar o Service Bus usando o PowerShell

A primeira etapa é escolher uma senha a ser usada na geração do certificado. Observe que essas etapas devem ser executadas em um janela de comando PowerShell do Service Bus. Crie uma cadeia de caracteres de segurança com a sua senha.

1. Escolha a senha a ser usada na geração do certificado. Emita o seguinte comando:

   $mycert=ConvertTo-SecureString -string <Password> -force -AsPlainText  
   

2. Crie um farm:

   New-SBFarm –SBFarmDBConnectionString "data source=localhost\sqlexpress;integrated security=true" –CertificateAutoGenerationKey $mycert  
   

3. Adicione um host ao farm

   Add-SBHost -CertificateAutoGenerationKey $mycert -SBFarmDBConnectionString "data source=localhost\sqlexpress; integrated security=true"  
   

   Dica

   Será solicitada a sua senha.

4. Verifique o status do farm

   Get-SBFarmStatus  
   

   O resultado esperado deve ser semelhante ao seguinte:

   HostName      ProcessName               Status  
   --------      -----------               ------  
   ...      Service Bus Gateway            Running  
   ...      Service Bus Message Broker     Running  
   ...      FabricHostSvc                  Running  
   

5. Crie o seu primeiro namespace de serviço

   New-SBNamespace –Name DemoSB –ManageUsers  yourDomain\yourUsername  
   

   O resultado esperado deve ser semelhante ao seguinte:

   Name                  : <Namespace Name>  
   AddressingScheme      : Path  
   CreatedTime           : 5/1/2012 5:30:49 PM  
   IssuerName            : <Namespace Name>  
   IssuerUri             : <Namespace Name>  
   ManageUsers           : {<domain\user>}  
   Uri                   :  
   ServiceIdentifier     :  
   PrimarySymmetricKey   : <GUID>  
   SecondarySymmetricKey :  
   

Se for necessário redefinir uma chave gerada automaticamente, emita o seguinte comando PowerShell:

Set-SBCertificateAutoGenerationKey –SBFarmDBConnectionString "data source=<hostname>\sqlexpress;integrated security=true"  

Provisionar um namespace do Service Bus usando o PowerShell (sem Windows Azure Pack)

1. Confira se um namespace de serviço foi criado ao emitir o seguinte comando Get-SBNamespace de PowerShell:

   Get-SBNamespace  
   

2. Caso nenhum namespace de serviço exista, crie um ao emitir o seguinte comando New-SBNamespace do PowerShell:

   New-SBNamespace -name DemoSB -ManageUsers yourDomain\YourAccount  
   

   Este comando cria um Service Bus namespace de serviço chamado “DemoSB”.

3. Recupera a cadeia de conexão do Service Bus ao emitir o seguinte comando Get-SBClientconfiguration do PowerShell:

   Get-SBClientconfiguration –namespace DemoSB