Base de conhecimento  /  Gerenciador de aplicativos em nuvem  /  Serviços gerenciados
Base de conhecimento  /  Gerenciador de aplicativos em nuvem  /  Serviços gerenciados

Introdução ao guia de integração CAM

Atualizado por Keith Homco em dez 18, 2017
Código do artigo: kb/125

Criar um aplicativo gerenciado no Cloud Application Manager (CAM)

Saiba como criar um aplicativo gerenciado no CAM, que seria suportado e gerenciado pela Lumen. Este artigo foi escrito para usuários internos da Lumen e, mais especificamente, aqueles familiarizados com Managed Services Anywhere (Serviços Gerenciados em Qualquer Lugar). À medida que o processo é refinado, a criação de aplicativos gerenciados será expandida para um público maior. Isso inclui clientes que desejam que seus aplicativos sejam gerenciados pela Lumen.

Antes de começar, inscreva-se para uma conta Cloud Application Manager (conta que se espera estar dentro da organização Lumen atualmente).

Então, siga estes passos simples.

  1. Configure uma script box para seu aplicativo
  2. Crie uma política de monitoramento
  3. Solicitar que a script box do seu aplicativo gerenciado (Linux ou Windows) seja compartilhada no seu espaço de trabalho
  4. Crie uma script box para ser a versão gerenciada do seu aplicativo
  5. Adicione a script box do aplicativo gerenciado como variável
  6. Passe os valores necessários à script box do aplicativo gerenciado
  7. Publique a script box

Configurar a script box do seu aplicativo

Com base em nossa experiência, sugerimos desenvolver a instalação e configuração do seu aplicativo em uma script box que possa ser implementada independentemente de ser gerenciada. Seguir esta prática permite pegar aplicativos existentes desenvolvidos em script boxes e aplicar as seguintes etapas para torná-lo um aplicativo gerenciado.

Para simplificar este artigo, isso é o que faremos. Usarei uma script box existente e disponível no CAM. Usarei a script box do servidor MongoDB.

cam-mongodb-scriptbox.png

Agora que meu trabalho aqui está concluído, vamos passar à próxima etapa.

Criar uma política de monitoramento

Vamos agora à página de monitoramento(https://monitoring.cam.ctl.io/), onde criaremos a política adequada para o monitoramento do nosso aplicativo. Manterei a simplicidade neste artigo, mas você deve criar uma política completa para o monitoramento do seu aplicativo.

Obs.: Observação: crie sua política no mesmo espaço de trabalho em que você criou sua application script box gerenciada

Clique no link Políticas à esquerda, que apresentará algo como o seguinte:

msa-managed-mongodb-watcher-policies.png

Clique em Nova, que mostrará um modal pop-up. Digite um nome e uma descrição aqui. Anote o nome, porque será usado mais tarde.

msa-managed-mongodb-watcher-policies-new.png

Aqui está nossa nova política, sem nenhuma verificação atualmente. Vou apenas adicionar uma simples verificação. Crie todas as verificações necessárias para o seu aplicativo. O catálogo de verificações pode ser acessado na guia Políticas do site de monitoramento e fornece uma lista de todos os tipos de verificação atuais que podem ser configurados.

msa-managed-mongodb-watcher-nochecks.png

Adicionei uma verificação de processo. Com as verificações necessárias implementadas, você pode passar à próxima etapa solicitando o uso da script box do aplicativo gerenciado.

msa-managed-mongodb-watcher-policies-onechecks.png

Solicitar que a script box do seu aplicativo gerenciado (Linux ou Windows) seja compartilhada no seu espaço de trabalho

Aqui você vai precisar solicitar que a script box de Managed Services Anywhere (Serviços Gerenciados em Qualquer Lugar) seja compartilhada em um espaço de trabalho designado escolhido por você. Será com esta script box que você será capaz de acionar o processo "Tornar gerenciado" para os aplicativos.

Obs.: Observação: uma versão do Windows e do Linux da application script box gerenciada será compartilhada com seu espaço de trabalho.

Por ora, é necessária uma carta de troca de e-mails para que a automação seja implementada. Achamos importante disponibilizar este recurso para você o mais rápido possível. São fornecidos links no portal do Gerenciador de aplicativos em nuvem para abrir um ticket.

Veja um exemplo de conteúdo do e-mail:

Obs.: Observação: confirme que já criou a política de monitoramento antes de enviar este e-mail

Dear Managed Services Anywhere,

I am requesting the creation of a new Managed Application for "MongoDB Server" with the monitoring policy named "mongodb-policy" under the "Managed OS Dev" workspace.

Please review the policy which corresponds to a suggested application name of "mongodb".

Thank you,
App Maker Man or Woman

A equipe de Managed Services Anywhere (Serviços Gerenciados em Qualquer Lugar) usará seus poderes especiais para transformar a política em um documento JSON que possa ser utilizado e armazenado com um mapeamento para o nome de aplicativo simples fornecido. Dessa forma, sempre que o aplicativo for implementado, esta definição de política de monitoramento será aplicada.

Aguarde o recebimento de um e-mail de Managed Services Anywhere (Serviços Gerenciados em Qualquer Lugar) dentro de 0 dias úteis, informando que esta parte do processo está concluída. Você verá a application script box gerenciada no espaço de trabalho fornecido e, com isso, pode completar as etapas abaixo. Além disso, a política de monitoramento que você criou pode então ser excluída se você desejar, já que a equipe de MSA só a utiliza como referência.

Criar uma script box gerenciada para seu aplicativo

Aqui você criará outra script box que funcionará como contêiner para a instalação/implementação do seu aplicativo, bem como para os esforços de tornar gerenciado. Veja abaixo a nova script box gerenciada do servidor MongoDB.

msa-managed-mongodb-scriptbox.png

Adicionei a application script box gerenciada, bem como a script box do servidor MongoDB como variáveis.

Obs.: Observação: selecione a implementação de plataforma (Windows/Linux) da application script box gerenciada adequada para as suas necessidades.

msa-managed-mongodb-scriptbox-vars.png

Passar os valores do aplicativo à application box gerenciada

Aprenda a passar valores à application script box gerenciada para tornar seu aplicativo disponível para suporte pela Lumen.

Primeiro, eu gostaria de apontar os eventos do ciclo de vida de um aplicativo gerenciado. Quando um aplicativo gerenciado é implementado, o processo "tornar gerenciado" é acionado e executado na computação antes de ser executado na application script box. É durante a execução na script box que a application script box gerenciada será executada nos eventos de strong1>pré_início e início do ciclo de vida. O pré_início simplesmente detecta se o processo de "tornar gerenciado" para a computação foi bem-sucedido antes de avançar. Se tiver falhado silenciosamente por alguma razão, a script box será interrompida aqui.

Espera-se então que o aplicativo sendo gerenciado já tenha iniciado ou seja iniciado no evento de início do ciclo de vida. Este é o ponto onde a ordem das variáveis mostradas anteriormente é importante; a application script box deve vir antes da application script box gerenciada. Somente depois que o aplicativo inicia com sucesso uma solicitação para torná-lo gerenciado deve ser feita.

Portanto, isso posto, usaremos na verdade qualquer evento do ciclo de vida antes do pré_início para passar os valores apropriados à application script box gerenciada. Geralmente é mais adequado fazer isso no evento de configuração da script box principal: neste caso, a script box Servidor MongoDB gerenciado. Servidor MongoDB gerenciado neste caso.

Veja abaixo uma vista ampliada das caixas incluídas nesta script box e suas respectivas variáveis para referência.

msa-managed-mongodb-scriptbox-expanded.png

Como APPLICATION_NAME, APPLICATION_DESCRIPTION, e APPLICATION_VERSION são valores obrigatórios na application script box gerenciada, você precisará substituir esses valores nesta nova script box gerenciada. Como a application script box "tornar gerenciado" subjacente é interna, esses valores não estarão visíveis no momento da implementação. Portanto, eles exigirão um valor padrão, conforme mostrado no exemplo abaixo. Você pode então expor suas próprias variáveis e scripts personalizados para substituir esses valores durante a execução de uma implementação.

msa-managed-mongodb-scriptbox-vars-defaults.png

Veja aqui uma figura da seção de eventos parcialmente ampliada. Observe que configuração é o único evento preenchido para a script box principal, porque funciona como um tipo de mapeamento entre a application script box e a application script box gerenciada.

msa-managed-mongodb-events-expanded.png

E você pode ver que eu preenchi o evento de configuração com alguns códigos. Veja abaixo o conteúdo desse evento do ciclo de vida:

Exemplo de Bash:

username=""
password=""
log_path=""
port=""
db_path=""

config="{\"username\": \"$username\", \"password\": \"$password\", \"db_path\": \"$db_path\", \"logs\": \"$log_path\", \"db_port\": \"$port\"}"

elasticbox set app.vars.APPLICATION_DESCRIPTION "My managed cross-platform document-oriented database"
elasticbox set app.vars.APPLICATION_VERSION ""
elasticbox set app.vars.APPLICATION_CONFIG "$config"

Exemplo de Powershell (se fosse windows):

$username = ""
$password = ""
$log_path = ""
$port = ""
$db_path = ""

$config = "{'username': '$username', 'password': '$password', 'db_path': '$db_path', 'logs': '$log_path', 'db_port': '$port'}"

elasticbox set app.vars.APPLICATION_DESCRIPTION "My managed cross-platform document-oriented database"
elasticbox set app.vars.APPLICATION_VERSION ""
elasticbox set app.vars.APPLICATION_CONFIG $config

Os scripts acima são basicamente valores de mapeamento da instalação da script box do servidor MongoDB Server para a application script box gerenciada. É também onde você pode usar suas variáveis personalizadas para substituir os valores padrão.

A APPLICATION_CONFIG destina-se a quaisquer metadados adicionais que você queira fornecer sobre o aplicativo e que seriam valiosos para suporte contínuo do aplicativo.

Observe também o APPLICATION_NAME; este valor é importante porque será usado para mapear este aplicativo com sua política de monitoramento correspondente na próxima etapa.

Publicar o aplicativo gerenciado

Aprenda a publicar a nova application script box gerenciada no catálogo público.

Esta etapa pode ser realizada paralelamente à etapa anterior de criação da política de monitoramento. Não é necessário aguardar uma resposta do MSA para publicar sua script box.

A publicação da sua script box é bem explicada aqui.

Powered by Translations.com GlobalLink OneLink SoftwarePowered By OneLink