Designer
Através da seção Designer é possível acessar todas as informações dos microsserviços existentes, como o autor, o script, datas de execução, problema que resolve ou tipo de licença; mas, acima de tudo, permite criar novos microsserviços.
Criação de microsserviços
Os microsserviços são criados em quatro fases:
Fase 1
- Acessar
Portal
->Microsserviços
->Designer
. - Clicar em
Novo
. - O assistente será aberto e pedirá para inserir as seguintes informações:
- Nome. Nome do microsserviço.
- Cor. Cor do ícone do microsserviço.
- Ícone. Tipo de ícone do microsserviço.
- Descrição. Breve texto que explica o que o microsserviço faz.
- Linguagem. Linguagem de programação com a qual foi desenvolvido.
- Versão. Número de versão do microsserviço.
- Âmbito. Âmbito de execução. Pode-se selecionar Workspace (contexto Sistema ou Sessão) ou Plataforma.
- Sistema operacional. Sistema operacional para o qual foi projetado.
- Categoria. Diretório ou grupo de microsserviços acessíveis a partir de Workspaces em que este microsserviço será hospedado.
- Eficiência. Quantidade de minutos que o microsserviço economiza a cada execução.
- Clique em
Avançar
.
Se o microsserviço for utilizado como microsserviço de usuário final, 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).
Fase 2 - Licença
- Escolher entre as opções suspensas o tipo de licença que o microsserviço terá.
- Clique em
Avançar
.
Fase 3 - README
- Inserir uma descrição do microsserviço em formato Markdown
- Clique em
Avançar
.
Para colocar um título com Markdown simplesmente deve-se iniciar a linha com # Título
. A seguir, alguns exemplos de sua sintaxe:
Elemento | Sintaxe Markdown | Pré-visualização |
---|---|---|
Negrito | **negrito** | negrito |
Itálico | *itálico* | itálico |
Lista | - Elemento da lista | - Elemento da lista |
Link | [texto](url) | texto |
Imagem |  | ![]() |
Código | código | código |
::: |
Fase 4 - Script
- Inserir o script.
- Clique em
Avançar
.
O microsserviço criado aparecerá na tabela principal da seção.
Código
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 o output esperado em relação à execução realizada. Por esse motivo, se estiver desenvolvendo um script em PowerShell deve-se 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 a partir do administrador local: em
Âmbito
é possível configurarWorkspaces
ouPlataforma
, o que facilita muito a interação com os 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 da sua sessão. -
Execução a partir da sessão do usuário: em
Âmbito
é possível configurarSessões
, 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 se desejar mostrar alguma mensagem na saída do microsserviço, recomenda-se usar o cmdlet "Write-Output" em vez de "Write-Host".
-
A saída da execução pode ser consultada nos detalhes do trabalho gerado na execução.