Pular para o conteúdo principal
Versão: 25.4

Microserviços

Através dos microsserviços, é possível criar, empacotar e publicar scripts para que as equipes técnicas da organização possam executá-los facilmente. Isso também permite delegar a níveis iniciais de suporte sua execução, de tal forma que se possa atender de forma eficaz às solicitações dos usuários e resolver os problemas mais frequentes.

Os microsserviços criados podem ser executados nos próprios dispositivos, com permissões de administrador local ou com as de sessão de usuário.

mercado

Também podem ser programados para serem executados no momento mais oportuno. Eles aceitam até mesmo gatilhos de eventos ou alertas, que podem ser usados como mecanismo de autorremediação diante da detecção de um problema.

Gerenciamento de microsserviços​

Os microsserviços têm várias opções de configuração que modificam seu comportamento; por exemplo, isso pode mudar dependendo se o script é executado a partir da sessão do usuário ou do administrador local.

Ativação no Portal​

Para ativar um microsserviço e tê-lo disponível para execução no Workspaces, deve-se ir ao Marketplace em Microsserviços do Portal. A partir daí, depois de explorar e encontrar o microsserviço de interesse, ele pode ser habilitado com o botão localizado no canto superior direito da interface.

Após alguns segundos, o microsserviço será visível em Workspaces e poderá ser executado nos dispositivos.

Criação de microsserviços​

Para criar um novo microsserviço, você deve acessar a seção Designer e clicar em Novo. O assistente será aberto e pedirá para inserir as seguintes informações:

  • Nome do microsserviço
  • Cor do ícone
  • Ícone do microsserviço
  • Breve descrição sobre o que faz o microsserviço
  • A linguagem com que foi desenvolvido
  • Número da versão
  • Âmbito de execução, sendo possível selecionar a nível de sistema (acesso administrativo) ou a nível de sessão (com a identidade do usuário)
  • Sistema operacional para o qual foi desenhado
  • Categoria: diretório ou grupo de microsserviços acessíveis desde Workspaces no qual será alojado este microsserviço
  • Eficiência temporal conseguida com cada execução
informação

O nome do microsserviço não deve conter caracteres especiais (como \ / : * ? " < > e outros caracteres específicos de idiomas para certas distribuições de teclado) se o microsserviço for utilizado como microsserviço de usuário final.

ms_creation

Estados dos microsserviços​

Os microsserviços têm três estados:

  • Habilitado
  • Desabilitado
  • Arquivado

Considerações sobre o código a ser usado​

Embora os microsserviços permitam a execução de qualquer comando CMD ou PowerShell em dispositivos Windows, os comandos enviados serão executados a partir do administrador local ou da sessão do usuário, dependendo do âmbito que lhes foi atribuído. Isso pode significar que alguns cmdlets não tenham a saída esperada em relação à execução realizada; por esse motivo, se estivermos escrevendo um script em PowerShell, devemos levar em consideração uma série de considerações:

  • É recomendado que a versão do PowerShell instalada nos dispositivos seja a mesma que a utilizada para desenvolver os microsserviços.

  • A execução dos microsserviços pode ser feita com a identidade da sessão do usuário ou pelo administrador local.

    • Execução pelo administrador local: em Scope pode ser configurado Applies to Workspaces ou Applies to servers, o que facilita muito a interação com processos, serviços e agir com permissões administrativas no dispositivo, mas pode dificultar o acesso a informações específicas do usuário ou sua sessão.

    • Execução pela sessão do usuário: em Scope, pode ser configurado Applies to user sessions, o que é muito útil para acessar informações do usuário, como o registro, informações contidas no perfil, etc. Deve-se ter em mente que o script será executado com o nível de permissões que o usuário tiver, então, se o usuário não for administrador local, ele terá certas limitações ao atuar em nível de sistema.

  • Quando queremos mostrar uma mensagem na saída do microsserviço, é recomendado usar o cmdlet "Write-Output" em vez de "Write-Host".

  • A saída da execução pode ser consultada nos detalhes do Job gerado na execução.

Maneiras de consumir os microsserviços​

Os microsserviços podem ser criados e habilitados no Portal, e a partir daí serem configurados para que sejam executados pelo usuário final, iniciados através de um Fluxo ou para que sejam executados com ações automatizadas ou de suporte desde Workspaces.

Execução pelo usuário final​

No Portal -> Habilitado ao clicar em um microsserviço, você acessa suas características. Na aba Destinatários -> Execução do Workspaces, são mostradas as permissões de execução que o microsserviço possui no Workspaces. Em Execução pelo usuário final, você pode ver se o microsserviço tem a opção de execução pelo usuário final habilitada; se for o caso, mostra o nome do usuário e o número de dispositivos onde está disponível.

target_microservice

Se a opção Execução pelo usuário final for ativada, o microsserviço adicionará um botão na tela inicial do dispositivo do usuário, para que ele possa executá-lo de maneira mais fácil e direta.

informação

Para obter mais informações sobre como habilitar um microsserviço para o usuário final, por favor, consulte este guia.

O nome do microsserviço não deve conter caracteres especiais (como \ / : * ? " < > e outros caracteres específicos de idiomas para certas distribuições de teclado) se o microsserviço for utilizado como microsserviço de usuário final.

ms_inicio

Uma alteração de configuração em um microsserviço de usuário final existente pode levar até 15 minutos para ser aplicada a todos os dispositivos vinculados.

Execução através de um fluxo​

Fluxos é uma funcionalidade que pode ser configurada no Portal. Permite criar fluxos de automação e executar um microsserviço de forma automática quando determinadas condições são atendidas no dispositivo.

Sua principal característica é que, através da execução de um microsserviço, simplifica as ações de diagnóstico proativo e resolve problemas rapidamente quando há um foco em sua detecção. Na seção Fluxos é possível obter mais informações sobre suas características e configuração.

Execução do Workspaces​

Desde o módulo Workspaces é possível executar qualquer microsserviço que tenha sido habilitado previamente no Portal. Para fazer isso, o usuário deve ir à aba Workspaces ou Sessions e selecionar o ou os dispositivos nos quais deseja aplicar o microsserviço.

Os microsserviços estarão disponíveis na aba Workspaces quando previamente configurados para serem executados no nível do sistema. E no Sessions quando na sua configuração foi selecionada a opção para ser executado no nível da sessão.

A autoridade para executar determinados microsserviços dependerá do papel ou das permissões que o usuário tem na plataforma.

type_ms_wsp