Descoberta de Pivotal Cloud Foundry

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 9 min. de leitura

    • A aplicação ServiceNow Descoberta encontra componentes Pivotal Cloud Foundry (PCF) versão 3 usando o padrão Pivotal Cloud Foundry. A descoberta de alguns desses recursos requer a atualização da aplicação  Padrões de descoberta e mapeamento de serviços a partir da ServiceNow Store.

    Você pode usar este padrão na Now Platform versão Kingston inicial.

    A descoberta de componentes do PCF V3 é compatível quando o plug-in Padrões de descoberta e mapeamento de serviços Versão 1.0.99, março de 2023 está instalado. O padrão continua a oferecer suporte à descoberta de componentes do PCF V2.

    Solicitar aplicativos na Store

    Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.

    Pré-requisitos

    Credenciais do Pivotal Cloud Foundry
    Crie as Pivotal Cloud Foundry credenciais.
    1. Navegar até Descoberta > Credenciais.
    2. Selecione Novo.
    3. Selecione Credenciais do CloudFoundry.
    4. No formulário, preencha os campos:
      Campo Descrição
      Nome Nome da credencial. Por exemplo, pcf_user credentials
      Ativo Opção para habilitar esta credencial para descoberta. Marque esta caixa de seleção para habilitar a descoberta.
      Aplica-se a Credenciais que você pode ou pode não desejar aplicar a Todos os MID Servers em sua rede, ou a um ou mais MID Servers específicos. Selecione MID Servers específicos.
      Ordem Ordem na qual a plataforma testa esta credencial ao tentar fazer login nos dispositivos. Um número menor indica que a credencial parece mais alta na lista. Estabeleça a ordem de credenciais ao usar um grande número de credenciais ou quando a segurança bloquear usuários após três tentativas de logins com falha. Se todas as credenciais tiverem o mesmo número de ordem, ou número nenhum, a instância vai tentar usar as credenciais em uma ordem aleatória. O valor padrão é 100.
      Nome de usuário Nome do usuário dessas credenciais. Evite espaços iniciais ou finais em nomes de usuário. Um aviso aparecerá se a plataforma detectar espaços iniciais ou finais no nome de usuário. Um exemplo é pcf_user. Use o client_id usado para gerar o token JWT.
      Senha Senha do usuário dessas credenciais. Use o client_secret usado para gerar o token JWT.
      Alias de credencial Nome alternativo para essas credenciais. Por exemplo, cf

      Se este campo estiver fechado, selecione o ícone de desbloqueio para desbloquear o campo.
    5. Selecione Atualizar.
    Credenciais do token da Web JSON
    Para verificar o token da Web JSON (JWT), execute as seguintes etapas de validação de token.

    O formato do token JWT é: https://docs.cloudfoundry.org/api/uaa/version/4.27.0/index.html#jwt-bearer-token-grant

    1. Execute o script cURL a seguir na API do servidor de autenticação e conta de usuário (UAA) e verifique os resultados:

      curl -s -k https://ip_address:port/oauth/token -X; POST -H ”Content-Type: application/x-www-form-urlencoded” -H “Accept: application/json” -d “client_id=<INSERT_USER_HERE>&client_secret=<INSERT_PASS_HERE>&grant_type=client_credentials&token_format=jwt&response_type=token”

      Se este comando não gerar um token, verifique se as credenciais no repositório ServiceNow estão corretas, caso contrário, vá para a etapa 2.

    2. Execute o seguinte script cURL na API do Pivotal Cloud Foundry:

      curvar https://ip_address:port/v3/spaces -k -v -H “Aceitar: aplicação/json” -H “Autorização: portador<INSERT TOKEN HERE> “

      Se este comando não recuperar as informações dos espaços do PCF, verifique as credenciais no repositório de credenciais ServiceNow.

    Credenciais para elementos da API V3
    Forneça a um usuário somente leitura permissão para usar os seguintes elementos de API:
    • –/v3/organizações
    • –/v3/espaços
    • –/v3/domains
    • –/v3/rotas
    • –/v3/organization_quotas
    • –/v3/space_quotas
    • –/v3/apps
    • -/v3/service_offerings
    • -/v3/service_plans
    • -/v3/service_instances
    • -/v3/gotas
    Nota:
    O padrão Pivotal Cloud Foundry também é compatível com as APIs PCF V2.
    Criar uma Descoberta programação sem servidor
    1. Navegar até Descoberta > Cronogramas de descoberta.
    2. Selecione Novo.
    3. No formulário, preencha os campos:
      Tabela 1. Formulário Programação do Descoberta
      Campo Descrição
      Nome Insira um nome exclusivo e descritivo para esta programação do Descoberta, por exemplo, pcf
      Descoberta Para o tipo de descoberta, selecione Sem servidor
      MID Server MID Servers aos quais as credenciais se aplicam. Especifique o MID Server necessário, por exemplo, Discovery_Server
      Ativo Opção para habilitar esta credencial para descoberta. Marque esta caixa de seleção para habilitar a descoberta.
      Alias de credencial Nome alternativo para essas credenciais. Use o alias relacionado às credenciais Pivotal Cloud Foundry que você criou anteriormente.
    4. Clique com o botão direito do mouse no formulário Programação do Descoberta e selecione Salvar.

      Padrão de execução sem servidor

    5. Selecione a guia Padrões de execução sem servidor.
    6. Selecione Novo.
    7. No formulário, preencha os campos:
      Tabela 2. Formulário Padrão de execução sem servidor
      Campo Descrição
      Nome Insira um nome exclusivo e descritivo para este padrão de execução sem servidor, por exemplo, pcf1
      Padrão Selecione CloudFoundry.
      Host de Proxy Nome de domínio totalmente qualificado da máquina na qual você está instalando o servidor proxy. Especifique Global.
      Ativo Caixa de seleção para habilitar esta programação para descoberta. Marque esta caixa de seleção.
    8. Clique com o botão direito do mouse no cabeçalho do formulário Padrões de execução sem servidor e selecione Salvar.
    9. Selecione a guia Padrões de execução sem servidor
    10. Crie e defina o padrão de execução sem servidor conforme descrito na documentação do produto.
      Configure os parâmetros exigidos pelo Padrão Pivotal Cloud Foundry da seguinte forma:
      Tabela 3. Parâmetros do inicializador de padrão do Descoberta
      Parâmetro Descrição
      Organização Nome da organização que deve ser descoberta ou todos em que a entrada é “*”.
      CredentialAlias Nome alternativo para essas credenciais. Use o alias relacionado às credenciais Pivotal Cloud Foundry que você criou anteriormente.
      URL_CF URL da API do controlador de nuvem que é usado para recuperar as informações de Pivotal Cloud Foundry.
      URL_CF_AUTH API do servidor UAA​usada para gerar o token. Insira o valor no formato: https://uaa.sys.dev.phx.pcf.example.com/oauth/token
    11. Atualize.
    12. Para iniciar a descoberta, navegue até a definição Sem servidor Descoberta e selecione Descobrir agora.
    Funções de fechamento EVAL

    Use as seguintes funções de fechamento EVAL para concatenar todas as organizações com "," como separador.

    var rtrn = ’’;
var organizations = ${organizations[*].name};
var beforeReturn = ’’;
var separator = ’’;
for (var i = 0; i < organizations.size(); i++)   
	{
	beforeReturn += separator + organizations.get(i);  
	separator = ',';   
	}
rtrn = beforeReturn;

    Use as seguintes funções de fechamento EVAL para retornar 1 se o status operacional estiver ativo e 2 se não estiver ativo.

    var rtrn = '';
var currentOrgStatus = ${organizations[].operational_status};
var status = currentOrgStatus.toLowerCase();
if(status == "active"){  
   rtrn = "1";  
}
else { 
   rtrn = "2";
}

    Use a seguinte função de fechamento EVAL para retornar 1 se o status operacional for iniciado e 2 se não for iniciado.

    var rtrn = '';
var currentAppStatus = ${apps[].state};
var status = currentAppStatus.toLowerCase();
if(status == "started"){
   rtrn = "1";  
}
else {   
   rtrn = "2";   
}
    CloudFoundry Get Call
    A operação personalizada CloudFoundry Get Call lida com a geração de tokens. Ela usa as credenciais e a variável de contexto URL_CF_AUTH para gerar um token que é usado para criar chamadas de API.

    Quando um token é gerado, o URL_CF é usado para criar as chamadas de API definidas no campo Recurso. A operação personalizada também lida com a paginação onde a resposta tem mais de uma página.

    O CloudFoundry Get Call analisa a entrada JSON para preencher as tabelas e variáveis.

    Operação personalizada do Cloud Foundry

    Pivotal Cloud Foundry BOSH seção de extensão

    O Pivotal Cloud Foundry BOSH é uma seção de extensão do Padrão Pivotal Cloud Foundry.

    A extensão está disponível em ServiceNow® Store para a versão de junho de 2023 da Padrões de descoberta e mapeamento de serviços 1.6.0.
    Requisitos para Pivotal Cloud Foundry BOSH
    Nota:
    Os requisitos a seguir são relevantes somente para a seção de extensão BOSH.
    O URL de autenticação do Opsman deve ser fornecido como um parâmetro de padrão com o nome URL_OPSMAN_AUTH. Por exemplo: https://<opsman entry point> /uaa/oauth/token
    As credenciais adicionadas devem ter permissão para executar as seguintes APIs:
    • /uaa/oauth/token
    • /api/v0/implantado/produtos
    Nota:
    APIs personalizadas são adicionadas como etapa de API Obter Tanzu Opsman ao padrão.

    Dados coletados pelo Descoberta durante a descoberta horizontal

    Tabela 4. Informações coletadas
    Campo Descrição
    IC principal: PCF Foundation [cmdb_ci_pcf_foundation]
    Nome Pivotal Cloud Foundry nome de entrada do cluster

    <name>- <hostCf:<portCf>
    ip_address Pivotal Cloud Foundry IP do host.
    port Pivotal Cloud Foundry porta de serviço.
    short_description Pivotal Cloud Foundry número de compilação do serviço.
    Organização Lista de organizações, gerenciada pelo cluster do PCF. As entradas são separadas usando um separador de vírgula ",".
    Organização do PCF [cmdb_ci_pcf_organization]
    Nome Nome da organização
    URL URL exclusivo da organização
    pcf_guid UID da organização no CF
    operational_status Status da organização
    Espaço PCF [cmdb_ci_pcf_space]
    Nome Nome do espaço
    URL URL exclusivo do espaço
    pcf_guid UID do espaço no CF
    Aplicação PCF [cmdb_ci_pcf_appl]
    Nome Nome da aplicação
    URL URL exclusivo da aplicação
    pcf_guid UID da aplicação no CF
    Rota PCF [cmdb_ci_pcf_route]
    Nome Nome da rota
    URL URL exclusivo de rota
    pcf_guid UID da rota no CF
    port Porta de rota
    type Tipo de rota
    Cota do PCF [cmdb_ci_pcf_quota]
    Nome Nome da cota
    URL URL exclusivo da cota
    pcf_guid UID de Cota no CF
    Domínio PCF [cmdb_ci_pcf_domain]
    name Nome do domínio
    url URL exclusivo do domínio
    pcf_guid UID de domínio no CF
    Instância do espaço do PCF [cmdb_ci_pcf_space_instance]
    name Nome da instância de serviço do espaço
    url URL exclusivo da instância de serviço do espaço
    pcf_guid UID da instância de serviço do espaço no CF
    Plano de serviço do PCF [cmdb_ci_pcf_service_plan]
    name Nome da instância do plano de serviço
    url URL exclusivo do plano de serviço
    pcf_guid UID da instância de serviço do espaço no CF
    Serviço PCF [cmdb_ci_pcf_service]
    name Nome do serviço
    url URL exclusivo de serviço
    pcf_guid UID do serviço no CF
    Gota de PCF [cmdb_ci_pcf_droplet]
    name URL do recurso
    pcf_guid ID do droplet
    url URL do droplet
    install_status Status da instalação: 1, "instalado"
    operational_status Status operacional: 1, "operacional"
    Chave/Valor [cmdb_key_value]
    chave Chave de marcador de recurso
    Nota:
    Esses dados são coletados somente para chamadas de API V3.
    valor Valor do marcador de recurso.
    Nota:
    Esses dados são coletados somente para chamadas de API V3.
    Tabela 5. Dados descobertos pela seção de extensão Pivotal Cloud Foundry BOSH
    Campo Descrição

    Implantação BOSH (cmdb_ci_bosh_deployment)
    Nome O nome de instalação do recurso.
    object_id O ID do produto implantado.
    install_status Codificado com o valor: 1= instalado.
    operational_status Codificado para o valor: 1= operacional.
    implantação_versão A versão do produto implantado.
    deployment_type O tipo do produto implantado.

    Relacionamentos entre ICs

    Esses relacionamentos são criados para oferecer suporte à descoberta do Pivotal Cloud Foundry.

    IC Relacionamento IC
    Espaço PCF [cmdb_ci_pcf_space]
    cmdb_ci_pcf_space Contains::Contained by cmdb_ci_pcf_organization
    Aplicação PCF [cmdb_ci_pcf_appl]
    cmdb_ci_pcf_appl Contains::Contained by cmdb_ci_pcf_space
    Rota PCF [cmdb_ci_pcf_route]
    cmdb_ci_pcf_route Contains::Contained by cmdb_ci_pcf_foundation
    Cota do PCF [cmdb_ci_pcf_quota]
    cmdb_ci_pcf_quota Uses::Used by cmdb_ci_pcf_space

    cmdb_ci_pcf_organization
    Domínio PCF [cmdb_ci_pcf_domain]
    cmdb_ci_pcf_domain Uses::Used by cmdb_ci_pcf_route
    Owns::Owned by cmdb_ci_pcf_organization
    Contains::Contained by cmdb_ci_pcf_foundation
    Instância do espaço do PCF [cmdb_ci_pcf_space_instance]
    cmdb_ci_pcf_space_instance Contains::Contained by cmdb_ci_pcf_space
    Plano de serviço do PCF [cmdb_ci_pcf_service_plan]
    cmdb_ci_pcf_service_plan Uses::Used by cmdb_ci_pcf_space_instance
    Serviço PCF [cmdb_ci_pcf_service]
    cmdb_ci_pcf_service Uses::Used by cmdb_ci_pcf_service_plan
    Gota de PCF [cmdb_ci_pcf_droplet]
    cmdb_ci_pcf_appl Contains::Contained by cmdb_ci_pcf_droplet
    Chave/Valor [cmdb_key_value]
    cmdb_key_value Somente referência.

    Por exemplo: configuration_item

    		 cmdb_ci_pcf_droplet
    cmdb_key_value Somente referência.

    Por exemplo: configuration_item

    		 cmdb_ci_pcf_organization
    cmdb_key_value Somente referência.

    Por exemplo: configuration_item

    		 cmdb_ci_pcf_space
    cmdb_key_value Somente referência.

    Por exemplo: configuration_item

    		 cmdb_ci_pcf_domain
    cmdb_key_value Somente referência.

    Por exemplo: configuration_item

    		 cmdb_ci_pcf_route
    cmdb_key_value Somente referência.

    Por exemplo: configuration_item

    		 cmdb_ci_pcf_appl
    cmdb_key_value Somente referência.

    Por exemplo: configuration_item

    		 cmdb_ci_pcf_service
    cmdb_key_value Somente referência.

    Por exemplo: configuration_item

    		 cmdb_ci_pcf_service_plan
    cmdb_key_value Somente referência.

    Por exemplo: configuration_item

    		 cmdb_ci_pcf_space_instance

    Pivotal Cloud Foundry Relacionamentos BOSH

    Esses relacionamentos são criados para oferecer suporte à descoberta da seção de extensão Pivotal Cloud Foundry BOSH.

    IC Relacionamento IC

    Cluster do Cloud Foundry [cmdb_ci_pcf_foundation]

    		 Contains::Contained by

    Implantação BOSH [cmdb_ci_bosh_deployment]