Primeiros Passos¶
Como Funciona¶
O Session Manager (Gerente de Sessão) monitora a fila de tarefas do Orquestrador BotCity em tempo real. Ele é responsável por ativar recursos sempre que houver tarefas em aguardo e desativá-los quando finaliza a execução e não há mais tarefas na fila.
Ele é otimizado para fornecer alocação de recursos em tempo hábil, garantindo a disponibilidade desses recursos quando necessário. Isso reduz tanto o tempo ocioso das tarefas em aguardo no Orquestrador BotCity, quanto o tempo de Runners ativos e ocioso sem tarefas para executar.
Fluxo de Processos:
- Monitoramento da Fila: O Session Manager monitora continuamente a fila de tarefas do Orquestrador BotCity.
- Ativação de Recursos: Quando há demanda de tarefas, os recursos são ativados para lidar com a carga.
- Desativação de Recursos: À medida que a demanda deixa de existir, os recursos são liberados e desativados, reduzindo os custos.
Conceitos-chave¶
Antes de mergulhar na configuração, é importante entender alguns conceitos-chave que serão referenciados abaixo:
host: Um host é um computador ou máquina virtual (localmente ou na nuvem) que terá sua sessão controlada. Esta máquina deve ser diferente da máquina onde o Session Manager está instalado e deverá ter os recursos do SDK da BotCity instalados.protocol: O protocolo a ser utilizado para a conexão e comunicação do Session Manager com ohost. Verifique a lista de protocolos suportados.
Protocolos Suportados¶
Atualmente, três protocolos são suportados:
- RDP
- AWS EC2 + RDP
- Azure VM + RDP
RDP - Área de Trabalho Remota¶
Para configurar um host com suporte para Área de Trabalho Remota, você precisará das seguintes informações:
- Nome do Host ou Endereço IP: para se comunicar com o
host. - Nome de usuário: para iniciar a sessão.
- Senha: para iniciar a sessão do usuário.
AWS EC2 + RDP¶
Este protocolo permite não apenas estabelecer a conexão RDP com o host, mas também manipular o estado da instância EC2 da AWS, iniciando e parando-a com base na demanda da fila de tarefas do Orquestrador BotCity.
Para configurar um host com suporte para AWS EC2, você precisará das seguintes informações:
- ID da Instância
- Nome do Host ou Endereço IP: para se comunicar com o
host. - Nome de usuário: para iniciar a sessão.
- Senha: para iniciar a sessão do usuário.
Durante a configuração, o CLI perguntará como fornecer as credenciais da AWS:
Usar arquivo de credenciais da AWS? (S/N)- Se Sim: solicita o
Nome do Perfil(padrão:default). - Se Não: solicita a
Região AWS,ID da Chave de Acesso AWSeChave Secreta de Acesso AWS.
- Se Sim: solicita o
Escolher uma opção de conexão EC2 (rdp): seleciona o tipo de conexão após a instância iniciar (atualmente apenasrdp).
Azure VM + RDP¶
Este protocolo permite configurar uma VM do Azure para funcionar manipulando o estado da VM e estabelecendo a conexão RDP, iniciando e parando-a com base na demanda da fila de tarefas do Orquestrador BotCity.
Disponibiliza duas opções para autenticação ao acessar recursos do Azure:
- Uso de Client Secrets — fornecendo Tenant ID, Client ID e Client Secret do Azure AD para acesso explícito
- Uso de Managed Identity — utilizando a identidade gerenciada da VM para acesso automático, sem precisar fornecer segredos
Para configurar o host para usar o Azure VM, você deverá informar os seguintes dados:
- Nome da VM onde a configuração será aplicada
- Grupo de Recursos da VM no Azure
- ID da Assinatura (Subscription ID) relacionada à VM
- Tenant ID (Opcional) identifica o diretório do Azure Active Directory (Azure AD) ao qual a aplicação pertence.
- Client ID (Opcional) identifica de forma única a aplicação registrada no Azure AD.
- Client Secret (Opcional) é a senha ou chave secreta associada à aplicação registrada, usada para autenticação segura.
Durante a configuração, o CLI perguntará:
Autenticar com Managed Identity?: se Sim, Tenant ID, Client ID e Client Secret são ignorados.Escolher uma opção de conexão da Azure VM (rdp): seleciona o tipo de conexão após a VM iniciar (atualmente apenasrdp).
Tip
Na autenticação da Azure VM, existem três formas principais de fornecer credenciais:
-
Client Secrets:
Use Tenant ID, Client ID e Client Secret quando quiser autenticar explicitamente via uma aplicação registrada no Azure AD.
Isso é útil em ambientes que não possuem Managed Identity habilitada ou para cenários que exigem credenciais específicas. -
Managed Identity:
Quando a VM possui Managed Identity habilitada, a autenticação é feita automaticamente sem necessidade de fornecer credenciais explícitas.
Essa é a forma mais segura e recomendada para aplicações rodando em Azure VMs. -
Arquivo de configuração padrão (Azure CLI / Environment Variables):
Caso você tenha o Azure CLI instalado e autenticado na máquina, ou defina as variáveis de ambienteAZURE_TENANT_ID,AZURE_CLIENT_IDeAZURE_CLIENT_SECRET, é possível usar essas configurações automaticamente.
Isso permite não precisar passar manualmente as credenciais no código.
Requisitos¶
Requisitos Mínimos
| Componente | Requisito |
|---|---|
| CPU | Processador Intel® Core™ i3 (3.20 GHz) ou compatível |
| RAM | 2GB |
| Sistema Operacional | Windows (7, 10, Server), Linux (Veja distribuições suportadas) ou MacOS |
| Java | Não necessita diretamente |
| Armazenamento | 500MB disponíveis para o aplicativo |
| Rede | Conectividade com a instância do BotCity Orquestrador (HTTPS) e com as sessões remotas |
O Session Manager deve executar em uma máquina dedicada e separada
O Session Manager não deve ser instalado na mesma máquina que qualquer host. Ele requer uma máquina própria e dedicada, em execução contínua, para monitorar o Orquestrador e gerenciar remotamente as sessões dos hosts.
Instalar o Session Manager em um host causará conflitos de sessão e impedirá o controle adequado de recursos.
Se não for possível usar o Session Manager no momento, veja a alternativa Iniciar sessão e Runner automaticamente na VM.
Para comunicação correta, a máquina do Session Manager deve:
- Poder se comunicar com o Orquestrador BotCity via HTTPS (Porta 443).
- Poder alcançar os
hostsvia rede para gerenciar as sessões. - Ter um usuário autorizado a estabelecer conexão RDP ou outra conexão necessária com os
hosts.
Comunicação apenas outbound
A comunicação do Session Manager com o Orquestrador BotCity é sempre outbound (de saída): o Session Manager inicia as requisições HTTPS em direção ao Orquestrador para consultar a fila de tarefas, e o Orquestrador nunca inicia conexões com a máquina do Session Manager. Não é necessário abrir portas de entrada (inbound) na máquina do Session Manager para essa comunicação.
Condições de uso dos hosts¶
Para que o Session Manager consiga abrir e encerrar as sessões corretamente, os hosts precisam seguir estas condições:
- Usuário exclusivo para o Session Manager: o usuário configurado no
hostdeve ser usado apenas pelo Session Manager. - Acesso com outro usuário: a máquina pode ser acessada por outras pessoas, desde que com um usuário diferente do configurado no Session Manager.
- Sem scripts de desconexão: não configure os parâmetros
startupebeforeTaskdo Runner com scripts de desconexão de usuário, como os descritos em Script de desconexão de sessão. Esses scripts interferem no controle das sessões feito pelo Session Manager.
Acesso ao host com o usuário do Session Manager
Se alguém acessar o host com o mesmo usuário configurado no Session Manager, o Session Manager perde a conexão com a sessão e não segue com o processo.
Para restabelecer o funcionamento:
- No
hostonde os Runners executam, desative o serviço do Runner. - Deslogue o usuário da sessão do
host. - Reinicie o Session Manager.
Instalação¶
O Session Manager faz parte do BotCity Studio SDK.
Para obter o Session Manager, prossiga com a instalação descrita no guia de introdução.
Instalação de Runner
Ao instalar do SDK para o uso exclusivo do Session Manager não é necessário fazer a configuração de Runner nessa instalação. O Runner deve ser instalado e configurado nos hosts, não na máquina do Session Manager.
Instalando como Serviço do Windows
Você pode instalar o BotCity Session Manager como um Serviço do Windows seguindo as instruções abaixo:
Tip
Você precisará de um sistema operacional Windows com privilégios administrativos.
Passo 1: Criar o Serviço
-
Abra o Prompt de Comando como Administrador:
- Pressione
Win + Xe selecione Prompt de Comando (Admin) ou Windows PowerShell (Admin).
- Pressione
-
Execute o seguinte comando para criar um novo serviço:
- Substitua
C:\caminho\para\seu\SessionManager.exepelo caminho completo para o seu arquivo.exe. - Nota: Certifique-se de que não há espaço entre
binPath=e o caminho.
- Substitua
Passo 2: Configurar o Serviço para Iniciar Automaticamente
-
Execute o seguinte comando para definir o serviço para iniciar automaticamente na inicialização do sistema:
-
Para iniciar o serviço imediatamente, use:
Passo 3: Verificar o Serviço
- Abra Serviços (pressione
Win + R, digiteservices.msce pressione Enter). - Localize
SessionManagerServicena lista de serviços para confirmar que ele aparece. - Verifique se o Tipo de inicialização do serviço está definido como Automático.
- Reinicie o sistema para verificar se o serviço inicia automaticamente ao inicializar.
Passo 4: Teste e Solução de Problemas
-
Para verificar o status do serviço, você pode usar:
-
Se o serviço não iniciar, verifique o
log_sm.txtna pastalogsdo BotCity Studio SDK. - Alternativamente, verifique o Visualizador de Eventos em Logs do Windows > Aplicativo.
Desinstalando o Serviço
Para remover o serviço, execute:
Esse comando exclui o serviço completamente.Configuração¶
Toda a configuração do Session Manager é realizada via a interface de linha de comando (CLI) do Session Manager e salvo no arquivo config_file.smdb (por padrão na pasta conf/ da instalação).
Para executar o Session Manager, é necessário pelo menos:
- Adicionar um
host - Anexar um
runneraohostadicionado
Personalizar local do banco de dados
Você pode personalizar o local do banco de dados de configuração do Session Manager definindo o caminho completo para o arquivo smdb em seu arquivo de configuração conf/conf.bcf sob o parâmetro sessionManagerDBPath.
Comandos¶
Aqui está a lista de comandos disponíveis para a configuração do Session Manager, para ver os detalhes, clique no comando desejado.
Exemplo Prático
Veja como configurar no guia prático: Session Manager.
host - add, edit, remove¶
Comandos para configuração de hosts no Session Manager.
runner - attach, edit, release¶
Comandos para configuração de runner no Session Manager.
list - all¶
Comando para listas as configurações feitas no Session Manager.
run - local¶
Comando para executar o Session Manager.
config - interval host, interval task¶
Comandos para configuração dos intervalos de tempo dos processos do Session Manager.
version¶
Comando para exibir a versão instalada do Session Manager.