Descoberta de Pivotal Cloud Foundry

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura

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

    Você pode usar este padrão no ServiceNow AI Platform Iniciando a versão Kingston .

    A descoberta de componentes PCF V3 é compatível quando Padrões de descoberta e mapeamento de serviços A versão do plug-in 1,0.99, março de 2023, está instalada. O padrão continua a oferecer suporte à descoberta de componentes 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 o. 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 tenta 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 credencial ao usar um grande número de credenciais ou quando a segurança bloquear os 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 nos nomes de usuário. Um aviso será exibido 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: aplicação/x-www-form-urlencoded” -H “Accept: aplication/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 estão no ServiceNow o repositório está correto, caso contrário, vá para a etapa 2.

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

      CURL https://ip_address:port/v3/spaces -k -v -H "Aceitar: Aplicação/json" -H "Autorização: Portador"

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

    Credenciais para elementos de API V3
    Forneça a um usuário somente leitura permissão para usar os seguintes elementos de API:
    • /v3/organizations
    • /v3/spaces
    • /v3/domains
    • /v3/rotas
    • /v3/organization_cotas
    • /v3/space_cotas
    • /v3/apps
    • /v3/service_offerings
    • /v3/service_plans
    • /v3/service_instances
    • /v3/gototas
    Nota:
    . Pivotal Cloud Foundry O padrão também oferece suporte às 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 ao Pivotal Cloud Foundry credenciais 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 Pivotal Cloud Foundry Padrão 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 precisa ser descoberta ou todas as em que a entrada é "*".
      CredentialAlias Nome alternativo para essas credenciais. Use o alias relacionado ao Pivotal Cloud Foundry credenciais que você criou anteriormente.
      URL_CF URL da API do controlador de nuvem usado para recuperar as informações do 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é Sem servidor Descoberta definição e selecione Descubra 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 o seguinte EVAL funções de fechamento para retornar 1 se o status operacional for 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 o seguinte EVAL função de fechamento 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

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

    A extensão está disponível no ServiceNow® Store Para a versão de junho de 2023 de Padrões de descoberta e mapeamento de serviços1,6.0.
    Requisitos para Pivotal Cloud Foundry BOSH
    Nota:
    Os requisitos a seguir são relevantes somente para a seção de extensão do BOSH.
    O URL de autenticação do Opsman deve ser fornecido como um parâmetro padrão com o nome URL_OPSMAN_AUTH. Por exemplo: https://<opsman ponto de entrada>/uaa/oauth/token
    As credenciais adicionadas devem ter permissão para executar as seguintes APIs:
    • /uaa/oauth/token
    • /api/v0/deployed/products
    Nota:
    APIs personalizadas são adicionadas como Tanzu Opsman Obter API Vá para o 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 da entrada do cluster

    <name>- <hostCf:<portCf>
    ip_address Pivotal Cloud Foundry IP do host.
    porta 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 de 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]
    nome Nome do domínio
    URL URL exclusivo do domínio
    pcf_guid UID de domínio no CF
    Instância do Espaço PCF [cmdb_ci_pcf_space_instance]
    nome 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]
    nome 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]
    nome Nome do serviço
    URL URL exclusivo de serviço
    pcf_guid UID do serviço no CF
    Droplet PCF [cmdb_ci_pcf_droplet]
    nome 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 do recurso.
    Nota:
    Esses dados são coletados somente para chamadas de API V3.
    Tabela 5. Dados descobertos pelo Pivotal Cloud Foundry Seção de extensão DE BOSH
    Campo Descrição

    Implantação DE BOSH (cmdb_ci_bosh_deployment)
    Nome O nome da instalação do recurso.
    object_id O ID do produto implantado.
    install_status Codificado para o valor: instalado. 1 .
    operational_status Codificado para o valor: 1: operacional .
    deployment_version 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 de 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 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
    Droplet PCF [cmdb_ci_pcf_droplet]
    cmdb_ci_pcf_appl Contains::Contained by cmdb_ci_pcf_droplet
    Chave/Valor [cmdb_key_value]
    cmdb_key_value Apenas referência.

    Por exemplo: Configuration_item

    		 cmdb_ci_pcf_droplet
    cmdb_key_value Apenas referência.

    Por exemplo: Configuration_item

    		 cmdb_ci_pcf_organization
    cmdb_key_value Apenas referência.

    Por exemplo: Configuration_item

    		 cmdb_ci_pcf_space
    cmdb_key_value Apenas referência.

    Por exemplo: Configuration_item

    		 cmdb_ci_pcf_domain
    cmdb_key_value Apenas referência.

    Por exemplo: Configuration_item

    		 cmdb_ci_pcf_route
    cmdb_key_value Apenas referência.

    Por exemplo: Configuration_item

    		 cmdb_ci_pcf_appl
    cmdb_key_value Apenas referência.

    Por exemplo: Configuration_item

    		 cmdb_ci_pcf_service
    cmdb_key_value Apenas referência.

    Por exemplo: Configuration_item

    		 cmdb_ci_pcf_service_plan
    cmdb_key_value Apenas referência.

    Por exemplo: Configuration_item

    		 cmdb_ci_pcf_space_instance

    Pivotal Cloud Foundry Relacionamentos DE BOSH

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

    IC Relacionamento IC

    Cluster do Cloud Foundry [cmdb_ci_pcf_foundation]

    		 Contains::Contained by

    Implantação DE BOSH [cmdb_ci_bosh_deployment]