---
sourceDocument: Yokohama Gestão de serviços de TI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de serviços de TI

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# GitHub ações do pipeline

# GitHub ações do pipeline {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura

Use essas ações em GitHubpipeline para interagir com Configuração de DevOpsmodelo de dados.  
Importante:  
A partir da versão Washington DC, o Configuração de DevOps está sendo preparado para descontinuação futura. Ele ficará oculto e não será mais instalado em novas instâncias, mas continuará sendo compatível. Para obter detalhes, consulte o artigo [Deprecation Process (Processo de descontinuação) \[KB0867184\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) na Base de conhecimento do Now Support.

GitHub pipelines declarativos e com script são compatíveis.

. ServiceNowConfiguração de DevOps Validar (serviceNow-devops-config-validate) e Exportação de configuração de DevOps (serviceNow-devops-config-export) GitHubAs ações são fornecidas para criar uma definição de pipeline específica.

## Validação de configuração de DevOps (serviceNow-devops-config-validate) {#devops-config-github-integration__section_rsc_wdj_psb}

Carregue e valide dados de configuração em um ServiceNowinstância.

Argumentos de entrada
:   {#devops-config-github-integration__table_k3q_bf4_tzb__entry__2}

    | Argumento | Descrição |
    |-|-|
    | url da instância | ServiceNow URL da instância. |
    | devops-integration-username | Configuração de DevOps nome de usuário de integração. |
    | devops-integration-user-password | Configuração de DevOps senha do usuário de integração. |
    | nome-da-aplicação | Configuração de DevOps nome da aplicação. |
    | target | Destino do modelo de dados em que os arquivos de configuração são carregados. Os destinos do modelo de dados de exemplo são: * `componente` * `collection` * `implantável` {#devops-config-github-integration__ul_yrv_h34_tzb} |
    | nome-implantável | Nome implantável no Configuração de DevOpsmodelo de dados. |
    | nome-da-coleção | (Opcional) Nome da coleção no modelo de dados. Necessário quando o destino é coleta. |
    | nome-caminho | (Opcional) Caminho do nome do nó no modelo de dados em que os arquivos de configuração são carregados. |
    | caminho-do-arquivo-de-configuração | Caminho do arquivo ao carregar um único arquivo ou padrão de caminho de arquivo com base no padrão de estilo Ant ao carregar vários arquivos para o modelo de dados. Consulte [Tarefas baseadas em diretório](https://ant.apache.org/manual/dirtasks.html)Para obter informações sobre padrões de estilo Ant no ApacheANT.1.10.14 Documentação do manual. |
    | formato de dados | Formato de dados dos arquivos de configuração. Os formatos de dados de exemplo são: * `CSV` * `INI` * `JSON` * `Propriedades` * `BRUTO` * `XML` * `YAML` {#devops-config-github-integration__ul_vpc_rg4_tzb} |
    | data-format-attribute | (Opcional) Atributos de formato de dados estendidos para analisar dados de configuração. |
    | confirmação automática | Entrada booliana (verdadeiro ou falso) para confirmar dados de configuração após o upload bem-sucedido. Valor padrão: `verdadeiro` |
    | validação automática | Entrada booliana (verdadeiro ou falso) para validar dados de configuração após confirmação bem-sucedida. Valor padrão: `verdadeiro` |
    | publicação automática | Entrada booliana (verdadeiro ou falso) para publicar dados de configuração após a validação bem-sucedida. Valor padrão: `verdadeiro` |
    | changeset | (Opcional) Abrir changeset associado à ação de carregamento. Se não for fornecido, um novo changeset será criado. |
    | snapshot-validation-timeout | (Opcional) Tempo máximo em minutos para concluir a validação antes de falhar na ação. Valor padrão: `60 ` |
    | falhas-terminate-on-policy-validation-failes | (Opcional) Entrada booliana (verdadeiro ou falso) para encerrar o. GitHubfluxo de trabalho após falhas de validação de política. Valor padrão: `falso` |
    [ ]

    {#devops-config-github-integration__table_k3q_bf4_tzb}

Saídas
:

    changeset-number

    :   Número do changeset associado à ação de carregamento.

    nome-snapshot

    :   Nome do snapshot mais recente do implantável.

    validation-status

    :   Status de validação do snapshot. Exemplo: `aprovado `, `passed_with_exception `, `falha `, `execution_error `, `not_validated `

    validation-results

    :   Os resultados da validação no formato JSON do snapshot.

Exemplo: Carregando arquivos de configuração para um implantável{#devops-config-github-integration__example-snapshot}
:

        upload_and_validate_job:
            name: Upload and validate
            needs: <upstream job>
            runs-on: ubuntu-latest
            steps:     
              - name: ServiceNow Devops Config Validate
                uses: ServiceNow/servicenow-devops-config-validate@v1.0.0-beta
                with:
                  instance-url: ${{ secrets.SN_INSTANCE_URL }}
                  devops-integration-username: ${{ secrets.SN_DEVOPS_CONFIG_USERNAME }}
                  devops-integration-user-password: ${{ secrets.SN_DEVOPS_CONFIG_PASSWORD }}
                  application-name: PaymentDemo
                  target: deployable
                  deployable-name: Production
                  name-path: web-api-v1.0
                  auto-commit: true
                  auto-validate: true
                  auto-publish: true
                  config-file-path: data/k8s/helm/*.yml
                  data-format: yaml
                  snapshot-validation-timeout: 60
                  terminate-on-policy-validation-failures: true

Exemplo: Carregando arquivos de configuração para uma coleção
:

        upload_and_validate_job:
            name: Upload and validate
            needs: <upstream job>
            runs-on: ubuntu-latest
            steps:     
              - name: ServiceNow Devops Config Validate
                uses: ServiceNow/servicenow-devops-config-validate@v1.0.0-beta
                with:
                  instance-url: ${{ secrets.SN_INSTANCE_URL }}
                  devops-integration-username: ${{ secrets.SN_DEVOPS_CONFIG_USERNAME }}
                  devops-integration-user-password: ${{ secrets.SN_DEVOPS_CONFIG_PASSWORD }}
                  application-name: PaymentDemo
                  target: collection
                  deployable-name: Production
                  collection-name: release-1.0
                  name-path: web-api-v1.0
                  auto-commit: true
                  auto-validate: true
                  auto-publish: true
                  config-file-path: data/k8s/helm/*.yml
                  data-format: yaml
                  snapshot-validation-timeout: 60
                  terminate-on-policy-validation-failures: true

Exemplo: Carregando arquivos de configuração para um componente
:

        upload_and_validate_job:
            name: Upload and validate
            needs: <upstream job>
            runs-on: ubuntu-latest
            steps:     
              - name: ServiceNow Devops Config Validate
                uses: ServiceNow/servicenow-devops-config-validate@v1.0.0-beta
                with:
                  instance-url: ${{ secrets.SN_INSTANCE_URL }}
                  devops-integration-username: ${{ secrets.SN_DEVOPS_CONFIG_USERNAME }}
                  devops-integration-user-password: ${{ secrets.SN_DEVOPS_CONFIG_PASSWORD }}
                  application-name: PaymentDemo
                  target: component
                  deployable-name: Production
                  name-path: web-api-v1.0
                  auto-commit: true
                  auto-validate: true
                  auto-publish: true
                  config-file-path: data/k8s/helm/*.yml
                  data-format: yaml
                  snapshot-validation-timeout: 60
                  terminate-on-policy-validation-failures: true

Exemplo: Carregando vários arquivos de configuração em uma única confirmação
:

        upload_and_validate_job:
            name: Upload and validate
            
            needs: <upstream job>
            runs-on: ubuntu-latest
            # Upload an XML file to a component
            steps:     
              - name: ServiceNow Devops Config Validate
                id: upload_and_validate_xml
                uses: ServiceNow/servicenow-devops-config-validate@v1.0.0-beta
                with:
                  instance-url: ${{ secrets.SN_INSTANCE_URL }}
                  devops-integration-username: ${{ secrets.SN_DEVOPS_CONFIG_USERNAME }}
                  devops-integration-user-password: ${{ secrets.SN_DEVOPS_CONFIG_PASSWORD }}
                  application-name: PaymentDemo
                  target: component
                  deployable-name: Production
                  name-path: web-api-v1.0
                  auto-commit: false
                  auto-validate: true
                  auto-publish: true
                  config-file-path: data/infra/v1/*.xml
                  data-format: xml
                  snapshot-validation-timeout: 60
                  terminate-on-policy-validation-failures: true

            # Upload a JSON file to the vars folder of a deployable
            steps:     
              - name: ServiceNow Devops Config Validate
                id: upload_and_validate_json
                uses: ServiceNow/servicenow-devops-config-validate@v1.0.0-beta
                with:
                  instance-url: ${{ secrets.SN_INSTANCE_URL }}
                  devops-integration-username: ${{ secrets.SN_DEVOPS_CONFIG_USERNAME }}
                  devops-integration-user-password: ${{ secrets.SN_DEVOPS_CONFIG_PASSWORD }}
                  application-name: PaymentDemo
                  target: component
                  deployable-name: Production
                  name-path: web-api-v1.0
                  auto-commit: true
                  auto-validate: true
                  auto-publish: true
                  config-file-path: data/infra/prod/*.json
                  data-format: json
                  snapshot-validation-timeout: 60
                  terminate-on-policy-validation-failures: true
                  changeset : ${{ steps.upload_and_validate_xml.outputs.changeset-number }}

## Exportação de configuração de DevOps (serviceNow-devops-config-export) {#devops-config-github-integration__section_ynh_3nq_11c}

Exporte dados de configuração usando ServiceNow Configuração de DevOps.

Argumentos de entrada
:   {#devops-config-github-integration__table_znh_3nq_11c__entry__2}

    | Argumento | Descrição |
    |-|-|
    | url da instância | ServiceNow URL da instância. |
    | devops-integration-username | Configuração de DevOps nome de usuário de integração. |
    | devops-integration-user-password | Configuração de DevOps senha do usuário de integração. |
    | nome-da-aplicação | Configuração de DevOps nome da aplicação. |
    | nome-implantável | Nome implantável no Configuração de DevOpsmodelo de dados. |
    | nome-exportador | Nome do exportador que exporta dados de configuração do Configuração de DevOpsmodelo de dados. |
    | nome-snapshot | (Opcional) Snapshot do qual exportar dados. Se um snapshot não for especificado, o snapshot mais recente para o implantável será usado. |
    | exporter-data-format | (Opcional) Formato para exportar os dados do snapshot. Os formatos de dados de exemplo são: * `CSV` * `INI` * `JSON` * `Propriedades` * `BRUTO` * `XML` * `YAML` {#devops-config-github-integration__ul_srz_khv_11c} |
    | exporter-argumentos | (Opcional) Argumentos a serem usados junto com o exportador. O valor deve ser um objeto JSON representado como uma cadeia de caracteres. |
    [ ]

    {#devops-config-github-integration__table_znh_3nq_11c}

Saída
:

    conteúdo-exportador

    :   Dados de configuração que o exportador exporta.

Exemplo: Exportar snapshot específico
:

        export:
            name: Export config
            needs: <upstream job>
            runs-on: ubuntu-latest
            steps:
            - name: ServiceNow DevOps Config Export
              uses: ServiceNow/servicenow-devops-config-export@v1.0.0-beta
              with:
                instance-url: ${{ secrets.SN_INSTANCE_URL }}
                devops-integration-username: ${{ secrets.SN_DEVOPS_CONFIG_USERNAME }}
                devops-integration-password: ${{ secrets.SN_DEVOPS_CONFIG_PASSWORD }}
                application-name: PaymentDemo
                deployable-name: Production
                exporter-name: returnDataforNodeName-now
                snapshot-name: Production-v1.dpl
                exporter-arguments: '{ "nodeName": "node1" }'

Exemplo: Exporte o snapshot implantado mais recente com parâmetros adicionais
:

        export:
            name: Export config
            needs: <upstream job>
            runs-on: ubuntu-latest
            steps:
            - name: ServiceNow DevOps Config Export
              uses: ServiceNow/servicenow-devops-config-export@v1.0.0-beta
              with:
                instance-url: ${{ secrets.SN_INSTANCE_URL }}
                devops-integration-username: ${{ secrets.SN_DEVOPS_CONFIG_USERNAME }}
                devops-integration-password: ${{ secrets.SN_DEVOPS_CONFIG_PASSWORD }}
                application-name: PaymentDemo
                deployable-name: Production
                exporter-name: returnDataforNodeName-now
                exporter-arguments: '{ "nodeName": "node1" }'
                exporter-data-format: XML


