Descoberta de Pivotal Cloud Foundry

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 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. A descoberta de alguns desses recursos pode exigir a atualização para a versão mais recente 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 o. 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

    Visite ServiceNow Storepara exibir todos os apps 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. Como exemplo, pcf_user
      Ativo Opção para habilitar esta credencial para descoberta. Marque esta caixa de seleção para habilitar a descoberta.
      Aplica-se a Credenciais às quais você pode ou não querer aplicar Todos os MID Servers em sua rede, ou para um ou mais MID Servers específicos . Selecione MID Servers específicos .
      Ordem Ordem na qual a plataforma tenta esta credencial enquanto tenta fazer login nos dispositivos. Um número menor indica que a credencial parece mais alta na lista. Estabeleça a ordem das credenciais 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 pedido ou nenhuma, a instância tentará 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 será exibido se a plataforma detectar espaços à esquerda ou à direita no nome de usuário. Um exemplo é pcf_user . Use o. client_id Que é usado para gerar o token JWT.
      Senha Senha do usuário dessas credenciais. Use o. client_secret Que é usado para gerar o token JWT.
      Alias de credencial Nome alternativo para essas credenciais. Como exemplo, cf

      Se este campo estiver fechado, selecione o ícone de desbloqueio para desbloquear o campo.
    5. Selecione Atualizar.
    JSON credenciais de token da web
    Para verificar o. JSON Token da web (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

      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 script cURL a seguir em Pivotal Cloud Foundry API:

      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 da API V3
    Forneça a um usuário somente leitura permissão para usar os seguintes elementos de API:
    • –/v3/organizações
    • –/v3/spaces
    • –/v3/domains
    • –/v3/rotas
    • –/v3/organization_quotas
    • –/v3/space_quotas
    • –/v3/apps
    • -/v3/service_offerings
    • -/v3/service_plans
    • -/v3/service_instances
    • -/v3/gotículas
    Nota:
    . Pivotal Cloud Foundry O padrão também oferece suporte às APIs PCF V2.
    Crie um servidor sem servidor Descoberta programação
    1. Navegar até Descoberta > Cronogramas de descoberta.
    2. Selecione Novo.
    3. No formulário, preencha os campos:
      Tabela 1. Descoberta Formulário de programação
      Campo Descrição
      Nome Insira um nome exclusivo e descritivo para isso Descoberta, por exemplo, pcf
      Descoberta Para o tipo de descoberta, selecione Sem servidor
      MID Server MID Servers às quais as credenciais se aplicam. Especifique o necessário MID Server, por exemplo, Servidor_Descoberta
      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 cabeçalho do Descoberta Formulário de programação e selecione Salvar .

      Padrão de execução sem servidor

    5. Selecione Padrões de execução sem servidor guia.
    6. Selecione Novo.
    7. No formulário, preencha os campos:
      Tabela 2. Formulário de 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 Cloud foundry .
      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. Descoberta Parâmetros do Inicializador de padrões
      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 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. Atualizar .
    12. Para iniciar a descoberta, navegue até Sem servidor Descoberta e selecione Descubra agora .
    EVAL funções de fechamento

    Use o seguinte EVAL funções de fechamento 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 as funções de fechamento retornam 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";   
}
    Obter chamada do cloudfoundry
    A operação personalizada Obter chamada do CloudFoundry lida com a geração de tokens. Ele 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 Recurso campo. A operação personalizada também lida com a paginação em que a resposta tem mais de uma página.

    Obter chamada do cloudfoundry 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 de 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 Obter API do Tanzu Opsman Passo 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 da compilação do serviço.
    Organização Lista de organizações, gerenciada pelo cluster 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 exclusiva do espaço
    pcf_guid UID do espaço em CF
    Aplicação PCF [cmdb_ci_pcf_appl]
    Nome Nome da aplicação
    URL URL exclusiva da aplicação
    pcf_guid UID da aplicação em CF
    Rota PCF [cmdb_ci_pcf_route]
    Nome Nome da rota
    URL URL exclusivo da rota
    pcf_guid UID da rota em CF
    porta Porta de rota
    tipo Tipo de rota
    Cota de PCF [cmdb_ci_pcf_quota]
    Nome Nome da cota
    URL URL exclusivo da cota
    pcf_guid UID de cota em CF
    Domínio PCF [cmdb_ci_pcf_domain]
    nome Nome do domínio
    URL URL exclusiva do domínio
    pcf_guid UID do domínio no CF
    Instância de espaço PCF [cmdb_ci_pcf_space_instance]
    nome Nome da instância do serviço de espaço
    URL URL exclusiva da instância de serviço de espaço
    pcf_guid UID da instância de serviço de espaço em 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 de espaço em CF
    Serviço PCF [cmdb_ci_pcf_service]
    nome Nome do serviço
    URL URL exclusiva do serviço
    pcf_guid UID de serviço no CF
    Droplet do 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 de 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: 1: instalado .
    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 a Pivotal Cloud Foundry descoberta.

    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 de 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 do 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 BOSH

    Esses relacionamentos são criados para oferecer suporte a Pivotal Cloud Foundry Descoberta de 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]