---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Descoberta de Pivotal Cloud Foundry

# Descoberta de Pivotal Cloud Foundry {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 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 {#pivotal-cloud-foundry__section_gvb_cql_rlb}

Acesse o site [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) 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](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).{#pivotal-cloud-foundry__inline-send-to-store}

## Pré-requisitos {#pivotal-cloud-foundry__section_q2r_gnx_1hb}

Credenciais do Pivotal Cloud Foundry
:   Crie as Pivotal Cloud Foundry credenciais.  
    1. Navegar até DescobertaCredenciais.
    2. Selecione Novo.
    3. Selecione Credenciais do CloudFoundry.
    4. No formulário, preencha os campos:  
       {#pivotal-cloud-foundry__table_gxd_ljv_2hb__entry__2}

       | Campo | Descrição |
       |-|-|
       | Nome | Nome da credencial. Por exemplo, <kbd class="ph userinput">pcf_user credentials</kbd> |
       | 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 é <kbd class="ph userinput">pcf_user</kbd>. 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, <kbd class="ph userinput">cf</kbd> Se este campo estiver fechado, selecione o ícone de desbloqueio para desbloquear o campo. |
       [ ]

       {#pivotal-cloud-foundry__table_gxd_ljv_2hb}
    5. Selecione Atualizar.
    {#pivotal-cloud-foundry__ol_exd_ljv_2hb}

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.
    {#pivotal-cloud-foundry__ol_nds_5xy_fhb}

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

    {#pivotal-cloud-foundry__ul_bcy_jvv_mwb}  
    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é DescobertaCronogramas de descoberta.
    2. Selecione Novo.
    3. No formulário, preencha os campos:  
       {#pivotal-cloud-foundry__table_i3d_bzy_fhb__entry__2}

       | Campo | Descrição |
       |-|-|
       | Nome | Insira um nome exclusivo e descritivo para esta programação do Descoberta, por exemplo, <kbd class="ph userinput">pcf</kbd> |
       | 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, <kbd class="ph userinput">Discovery_Server</kbd> |
       | 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. |
       [Tabela 1. Formulário Programação do Descoberta]

       {#pivotal-cloud-foundry__table_i3d_bzy_fhb}
    4. Clique com o botão direito do mouse no formulário Programação do Descoberta e selecione Salvar.

    5. Selecione a guia Padrões de execução sem servidor.
    6. Selecione Novo.
    7. No formulário, preencha os campos:  
       {#pivotal-cloud-foundry__table_k3d_bzy_fhb__entry__2}

       | Campo | Descrição |
       |-|-|
       | Nome | Insira um nome exclusivo e descritivo para este padrão de execução sem servidor, por exemplo, <kbd class="ph userinput">pcf1</kbd> |
       | 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. |
       [Tabela 2. Formulário Padrão de execução sem servidor]

       {#pivotal-cloud-foundry__table_k3d_bzy_fhb}
    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:{#pivotal-cloud-foundry__table_l3d_bzy_fhb__entry__2}

        | 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 |
        [Tabela 3. Parâmetros do inicializador de padrão do Descoberta]

        {#pivotal-cloud-foundry__table_l3d_bzy_fhb}
    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.

## Dados coletados pelo Descoberta durante a descoberta horizontal {#pivotal-cloud-foundry__section_dpt_psd_bhb}

{#pivotal-cloud-foundry__table_o21_dlv_2hb__entry__2}

| 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 4. Informações coletadas]

{#pivotal-cloud-foundry__table_o21_dlv_2hb}


## Relacionamentos entre ICs {#pivotal-cloud-foundry__section_tfg_rsd_bhb}

Esses relacionamentos são criados para oferecer suporte à descoberta do Pivotal Cloud Foundry.  
{#pivotal-cloud-foundry__table_vkt_ywd_rdb__entry__3}

| 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 |
| cmdb_ci_pcf_domain | Owns::Owned by | cmdb_ci_pcf_organization |
| cmdb_ci_pcf_domain | 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__table_vkt_ywd_rdb}