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

Microserviços

Através de Microservices é 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 aos 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 microserviços criados podem ser executados nos próprios dispositivos, com permissões de administrador local ou com as de sessão de usuário.

marketplace

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

Gestão 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 em Workspaces, deve-se ir a Marketplace em Microsserviços de Portal. A partir daí, após explorar e encontrar o microsserviço de interesse, ele poderá ser habilitado com o botão localizado na parte superior direita da interface.

Pasados unos segundos, el microservicio será visible en Workspaces y podrá ser ejecutado en los dispositivos.

Criação de microsserviços

Para criar um novo microsserviço, deve-se acessar a seção Designer e clicar em Novo. O assistente será aberto e solicitará a introdução das 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 a qual está 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 está projetado
  • Categoria: diretório ou grupo de microsserviços acessíveis a partir de Workspaces em que este microsserviço será hospedado
  • Eficiência temporal alcançada com cada execuçã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 microserviços têm três estados:

  • Habilitado
  • Desabilitado
  • Arquivado

Considerações sobre o código a utilizar

Embora os microsserviços permitam a execução de qualquer comando CMD ou PowerShell em dispositivos Windows, os comandos enviados serão executados pelo administrador local ou pela sessão do usuário, dependendo do escopo que lhes for atribuído. Isso pode significar que alguns cmdlets não tenham o output esperado em relação à execução realizada; por esse motivo, se estiver realizando um script em PowerShell, deve-se levar em consideração uma série de aspectos:

  • Recomenda-se 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 realizada sob a identidade de sessão do usuário ou do administrador local.

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

    • Execução a partir da sessão do usuário: em Scope pode-se configurar 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 levar em consideração que o script será executado com o nível de permissões que o usuário tem, então, se o usuário não for administrador local, terá certas limitações quando desejar agir a nível de sistema.

  • Quando quisermos mostrar alguma mensagem no output do microsserviço, recomenda-se usar o cmdlet "Write-Output" em vez de "Write-Host".

  • O output da execução pode ser consultado nos detalhes do Job gerado na execução.

Formas de consumir os microsserviços

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

Execução pelo usuário final

No Portal -> Habilitado, ao clicar em um microsserviço, acessa-se suas características. Na aba Destinatários -> Execução a partir do Workspaces são exibidas as permissões de execução que o microsserviço possui no Workspaces. A seguir, em Execução pelo usuário final, pode-se ver se o microsserviço tem habilitada a opção de ser executado pelo usuário final, e, nesse caso, exibe 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 estiver ativada, o microsserviço adicionará um botão na tela inicial do dispositivo do usuário, para que ele possa executá-lo de uma maneira mais fácil e direta.

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, por meio da execução de um microsserviço, simplifica as ações de diagnóstico proativo e resolve os problemas rapidamente quando há um foco em sua detecção. Na seção Flujos pode-se obter mais informações sobre suas características e configuração.

Execução a partir do Workspaces

Desde el módulo Workspaces se puede ejecutar cualquier microservicio que haya sido habilitado previamente en Portal. Para isso, o usuário deve ir até a aba Workspaces ou Sessions e selecionar o(s) dispositivo(s) nos quais deseja aplicar o microsserviço.

Os microsserviços estarão disponíveis a partir da aba Workspaces quando previamente configurados para serem executados a nível de sistema. E a partir de Sessions quando, na configuração, a opção de execução em nível de sessão for selecionada.

A capacidade de executar determinados microsserviços dependerá do papel ou permissões que o usuário possui na plataforma.

type_ms_wsp