Azure App Service
Descreve como fazer o deploy da API de integração com o SQL Server Usando o App Service
O Azure App Service é um serviço do Azure em que você pode facilmente subir aplicações web usando imagens docker. Este é o jeito mais rápido de subir a API da integração se a sua instância SQL consegue estar disponível para o Range de IPs do Azure.
Pré-Requisitos
Solicite o Registry Password no seu canal de suporte do Power Omni. Você vai precisar informá-lo
Prepare a string de conexão para sua Instância SQL
Server=endereco,porta;Database=NomeBanco;User Id=NomeLogin;Password=TroquePorUmaSenhaForte
Passo a Passo
Para iniciar o processo, clique nesse link, que vai abrir um formulário no seu portal do azure.
Preencha os campos: Assinatura, Resource Group, String Conexão e Registry Password com as informações que você preparou no pré-requisito.
Subscription Assinatura
Escolha a assinatura onde vai criar o recurso
Resource Group Grupo de Recursos
Escolha em qual resource group vai criar o App Service. Você pode escolher o mesmo onde instalou o Power Omni (geralmente possui poweromni no nome)
String Conexao
Coloque a String de Conexão, conforme você preparou nos pré-requisitos. Você pode alterá-la depois, se precisar. Se a instância ainda não está pronta, não tem problemas. Pode preencher a string de conexão com os valores que você planejar criar no sql ou deixar vazios para alterar depois
Registry Password
Este é um token para que você consiga baixar a imagem criada pela Power Tuning. Peça no seu canal de suporte.
Os demais campos pode deixar como está. Altere somente se você entende o que está fazendo ou sob orientação do time do Power Omni.
Então, clique em Review +Create (Examinar + Criar), e em seguida no botão Criar/Create:
Por padrão, o plano usado é o mais barato do Azure. Confira os preços aqui: https://azure.microsoft.com/en-us/pricing/details/app-service/linux/
O Azure vai fazer algumas validações quando você clicar neste botão. Se algum erro for retornado, você deve procurar ou administrador da sua conta do Azure ou o seu parceiro para ajudar a solucionar
A Azure Brasil fornece serviços exclusivos que podem te ajudar a configurar e resolver problemas na sua conta no Azure, além de conseguirem preços especiais nas assinaturas.
Se você precisar de apoio com seu Azure, procure no canal de suporte do omni que conseguimos te colocar em contato com o time da Azure Brasil.
Se não houve erros na validação, o processo vai seguir e deve ser concluido em alguns minutos. É só aguardar.
Quando for concluído, você vai ver uma tela parecida com esta:
Clique em "Deployment Details", e clique no link referente ao recurso do tipo Microsoft.Web/sites:
Isso vai te levar para a página principal do seu App Service. Neste momento, ele deve estar tentando fazer o donwload da imagem docker do registro da Power Tuning. Para consultar o progresso, vá na lateral, em Settings -> Instances:
Se tudo ocorreu bem, você vai ver uma tela parecida com esta:
Caso tenha ocorrido erros, você vai ver nessas colunas de status. O erro mais provável é que o token que você forneceu possa estar incorreto (expirado, pode ter colado com algum caracter a mais, como um espaço ou quebra de linha, etc.). Caso tenha problemas aqui, procure o suporte do Power Omni.
Acessando a tela de overview, você poderá obter a URL da sua API. Clique nela para saber se o deploy jpa foi feito:
No exemplo acima, a url é: https://poweromni-sql-7db5twmqfrol4.azurewebsites.net/
Basta clicar nela, e uma nova janela do brower deverá ter sido aberta com a mensagem "Não autorizado!"
Isso indica que a instalação foi feito com sucesso, e você está recebendo esta mensagem porque não informou nenhuma API KEY.
Se aparecer "não autorizado" é porque o deploy foi feito com sucesso. Se ele demorar para carregar ou aparece outro erro que não seja a mensagem de autorização, ele pode estar fazendo o deploy ainda ou houve algum erro. Você pode tentar debugar pelos logs do App Service ou pedir apoio ao suporte do Power Omni.
Configurações
Se você recebeu a mensagem de não autorizado é porque o serviço subiu e você precisa informar as ApiKeys. Elas foram geradas aleatoriamente durante o deploy, e você vai encontrar indo no seu seu App Service -> Settings -> Environment Variables.
Aqui é onde se encontram as configurações do seu App Service.
A env KEYS contém a lista de keys geradas. Por padrão, 4 keys são geradas, cada uma separado por um ponto vírgula. Escolha uma delas para usar como teste, e acessa a url, passando https:/../apikey=ApiKeyEscolhida.
Exemplo de keys criadas aleatoriamente Se você passou a api key certa, a mensagem de erro não autorizado irá mudar, e um texto "working" com um número de versão serão retornado
A env SQL_CONNECTION, contém a string de conexão com o seu SQL Server. Se você precisa mudar algo, basta ajustar aqui.
IMPORTANTE: JAMAIS COMPARTILHAR ESSAS CONFIGURAÇÕES
Estes dados que você informou ou que foram gerados, são sensíveis. São dados que somente sua aplicação ou PowerOmni devem ter acesso (você configura a apikey ao configurar o conector no PowerOmni).
Então, jamais compartilhe como em prints acima.
Para este guia, os compartilhamentos foram feitos, mas esse app service criado foi de teste e não existe mais. No seu caso, como será usado em produção, você jamais deve fazer algo parecido.
Você pode alterar qualquer umas dessa variáveis a qualquer momento (isso vai causar um restart do seu web app, e pode causar erros esporádicos no omni se ele tentar invocar enquanto ele faz o restart).
Para visualizar os da sua app, vá em Log Stream:
Neste log você consegue ter acesso a todos os logs que a API desta integração gera, incluindo os erros. Se algum usuáro estiver tendo problemas com as respostas, como erros que ocorrem no banco, ou a se conectar com ele, esse log pode ser de grande ajuda!
Em todo o caso, se tiver dificuldades, procure o suporte do Power Omni!
Regras de Firewall com o SQL Server
É comum que você precise limitar a conexão com o seu SQL Server através de regras de firewall. Caso você precise liberar uma faixa de IPs, você pode obter a lista pelo quais os IPs da sua App Service saem usando o menu Settings -> Networking (configurações -> rede):
No canto direito dessa tela, você terá a lista de endereços que precisa liberar, pois a conexão com sua instância SQL pode sair por qualquer um deles. Clique em "Show more" para ver a lista completa.
Se você precisa isolar mais os números de IPs, você vai precisar fazer configurações mais avançadas de rede com o seu App Service. Procure o seu time responsável pela segurança no Azure para te ajudar.Se você não possui, pode solicitar uma consultoria do time da Azure Brasil, que é parceiro da Power Tuning. É só solicitar no seu grupo de suporte que colocamos em contato.
Próximos passos
Agora que você já sabe como obter a URL da sua API e a APIKEY, pode prosseguir com a configuração no Power Omni!
Atualizado