--- 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 --- # Artefatos e pacotes # Artefatos e pacotes {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 13 min. de leitura Artefatos e pacotes habilitados Velocidade de mudança para DevOpspara rastrear atividades de desenvolvimento e teste em uma ampla variedade de modelos de implantação e versão. Este recurso garante que a atividade do pipeline seja armazenada no DevOpso modelo de dados pode ser recuperado e aplicado quando artefatos são criados e liberados em momentos diferentes ou em pipelines diferentes. Artefatos Quando uma versão de artefato é registrada, atividades relacionadas, como confirmações, testes e verificações de código, são rastreadas para que, independentemente de quando a versão do artefato for implantada, esses detalhes possam ser recuperados. Pode ser na execução do pipeline atual, uma execução posterior do mesmo pipeline, um pipeline acionado pelo atual ou um pipeline separado acionado independentemente. Quando você associa confirmações a uma versão de artefato (pipeline de IC) e define um pacote de artefato (pipeline de CD), todas as versões de artefato geradas desde a última vez que o app foi implantado na produção são incluídas na lista de confirmações da mudança. A consolidação desses itens é útil, especialmente quando há várias compilações de IC antes da implantação. DevOps atributos da solicitação de mudança: * Categoria DevOpsou o. Categorize as solicitações de mudança de DevOps no campo "Mudança de DevOps" está marcada em DevOpspropriedades. Para obter mais informações, consulte [DevOps solicitação de mudança sem categoria obrigatória como DevOps](https://servicenow-prod.fluidtopics.net/nsh1Bz6lTbQpAAW4DNNy8A "Habilite a categorização DevOpssolicitação de mudança de DevOpspropriedades. As solicitações de mudança criadas como parte das etapas de execução do pipeline podem ser criadas com uma categoria diferente de DevOps."). * Confirmações e listas relacionadas a itens de trabalho {#using-dev-ops-release-change__ul_tbs_m2x_rkb} Packages Um pacote rastreia quando uma ou mais versões de artefato estão sendo usadas em um pipeline de implantação. Isso fornece dois benefícios importantes: 1. Recuperação de atividades para todas as versões de artefato declaradas no pacote. Por exemplo, para uso em uma política de aprovação de mudança automatizada. 2. Registro de quando uma versão de artefato especificada foi lançada com sucesso, garantindo que as informações vinculadas a ela não sejam mais consideradas. Por exemplo, para solicitações de mudança posteriores. {#using-dev-ops-release-change__ol_gkm_mtq_d1c} ## Configuração de artefato {#using-dev-ops-release-change__section_tf5_l24_rkb} 1. [Crie um registro de ferramenta de artefato no DevOps](https://servicenow-prod.fluidtopics.net/LvbLnG72b0VvMKAbEXDMLQ "Integre orquestração, planejamento, codificação, artefato, qualidade de software, e ferramentas de segurança com Velocidade de mudança para DevOpspara rastreabilidade e automação de mudanças de ponta a ponta."). Nota: Uma ferramenta de artefato não é necessária, a menos que uma configuração de webhook ou subfluxo de integração criada pelo usuário seja necessária para pesquisar versões de artefato. 2. Registre artefatos no pipeline de IC. 3. Crie um pacote no pipeline de CD. Nota: A etapa de criação do pacote deve ser anterior à etapa de implantação de produção. {#using-dev-ops-release-change__ol_b4v_n24_rkb} ## Registro de artefato {#using-dev-ops-release-change__section_anl_cyb_rkb} Configure o registro de artefato em um pipeline com script ou trabalho de estilo livre usando [DevOps API](https://www.servicenow.com/docs/access?context=devops-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US) /artefato/registro endpoint. Há suporte para várias versões de artefato. Para Jenkinspipeline: * Pipeline declarativo e com script ( Artefato snDevOpsArtefato Jenkinsfile) Por exemplo: snDevOpsArtifact(artifactsPayload: """{"artifacts": [{"name": "sa-web.jar", "version": "1.9","semanticVersion": "1.9.0","repositoryName": "services-1031"}], "branchName": "master"}""") * Trabalho de estilo livre ( Registrar artefato etapa de compilação) Por exemplo: {"artifacts":[{"name":"sentiment-analysis-web2","version":"1.9","semanticVersion":"1.9.0","repositoryName":"maven-releases"}]} {#using-dev-ops-release-change__ul_iwf_dfb_rkb} ## Criação de pacote de artefatos {#using-dev-ops-release-change__section_ixz_nyb_rkb} Importante: Você deve adicionar a etapa de criação de pacote antes da etapa de mudança no pipeline, e a criação de pacote deve ser adicionada em uma fase anterior à etapa de mudança, para que os pacotes sejam vinculados à execução do pipeline para uma solicitação de mudança. Configure a criação de pacote de artefatos em um pipeline com script ou trabalho de estilo livre usando o. [DevOps API](https://www.servicenow.com/docs/access?context=devops-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US) /pacote/registro endpoint. Nota: O nome do pacote deve ser especificado. Para Jenkinspipeline: * Trabalho de estilo livre ( Criar pacote etapa de compilação) Por exemplo: {"artifacts":[{"name":"sentiment-analysis-web2","version":"1.9","repositoryName":"maven-releases"}]} * Pipeline declarativo e com script ( Pacote snDevOps Jenkinsfile) Pacote com mais de um artefato (de repositórios diferentes) na carga, por exemplo: snDevOpsPackage(name: "sentimentpackage", artifactsPayload: """{"artifacts":[{"name": "sa-web.jar", "version": "1.9", "repositoryName": "services-1031"}, "{"name": "sa-db.jar", "version": "1.3.2", "repositoryName": "services-1032"}], "branchName": "master"}""") {#using-dev-ops-release-change__ul_ntg_kyb_rkb} Nota: Quando uma versão de artefato não está disponível durante a compilação, os detalhes da compilação (pipelineName ou ProjectName, taskExecutionNumber, stageName, branchName) são usados para pesquisar a versão do artefato na execução da tarefa. Jenkinsetapa do plug-in IncludeBuildInfo Pode ser usado para incluir detalhes de compilação na chamada de API. ## Objetos e fluxo de trabalho do artefato {#using-dev-ops-release-change__section_ul3_gqc_rkb} O trabalho da ferramenta de orquestração publica o novo artefato (que consiste em versões) no repositório de artefatos. Cada versão do artefato está associada a uma execução de tarefa (que consiste nas confirmações de código relacionadas). Um pacote é criado para a versão (que consiste em versões de artefato específicas sinalizadas para implantação) e, após a conclusão da fase de implantação, o pacote é marcado como implantado na produção. Esses objetos fazem parte da estrutura do artefato. * Ferramenta de artefato Usado para oferecer suporte a gerenciadores de repositório de artefatos, como JFrogArtifactory. Nota: Uma ferramenta de artefato não é necessária, a menos que uma configuração de webhook ou subfluxo de integração criada pelo usuário seja necessária para pesquisar versões de artefato. * Repositório de artefato Destino para artefatos gerados em uma compilação e também uma fonte de artefatos necessários para uma compilação. Pode ser criado manualmente ou por meio da API RegisterArtifact conforme novos artefatos são publicados em novos repositórios em uma ferramenta. * Artefato Nome do artefato para o qual diferentes compilações (versões de artefato) são geradas. Pode ser criado manualmente ou por meio da API RegisterArtifact. Os artefatos (versões) são associados a uma execução de tarefa e publicados em um repositório de artefatos. * Versão do artefato Versão específica do artefato. Componente implantável de uma aplicação gerado por uma compilação de IC. Quando fornecida, a versão semântica é usada. Pode ser criado por meio da descoberta ou pela API RegisterArtifact. Os artefatos (versões) são associados a uma execução de tarefa e publicados em um repositório de artefatos rastreados. * Versão de semântica Atributo opcional de uma versão de artefato que, quando fornecida, é usada para determinar confirmações de uma mudança. O formato da versão semântica é (MAJOR.MINOR.PATCH). * Pacote Coleção de versões de artefatos usadas como entrada para um pipeline de CD ou para associar resultados de testes. A criação de pacote é acionada pela chamada da API CreatePackage da ferramenta de orquestração e contém o nome, a versão e o nome do repositório de todas as versões de artefato incluídas no pacote. Uma caixa de seleção indica se o pacote foi implantado na produção. {#using-dev-ops-release-change__ul_jdc_jmr_21c} DevOps aceleração de mudança para versões: Figura 1. DevOps Solicitação de mudança -- categoria DevOps Figura 2. DevOps solicitação de mudança - confirmações e itens de trabalho Figura 3. DevOps lista de versões do artefato Figura 4. DevOps versão do artefato - confirmações Figura 5. DevOps versão do artefato - pacotes Figura 6. DevOps pacote Você também pode ver todas as solicitações de mudança de pipeline existentes diretamente do Mudanças no navegador de aplicações. Figura 7. Módulo de mudanças Você pode ver todas as solicitações de mudança de pipeline e controle de mudanças existentes diretamente usando o. Mudanças no navegador de aplicações. Navegar até Espaço de mudança de DevOpsmudarSolicitações de mudança de pipelineTudo para todas as informações relacionadas à mudança. Solicitações de mudança de pipeline Figura 8. Módulo de lista Você pode ver todos os artefatos e pacotes existentes diretamente usando o. Lista no navegador de aplicações. Navegar até Espaço de mudança de DevOpsListasArtefato para todas as informações relacionadas ao artefato. ## Monitoramento de artefatos e pacotes {#using-dev-ops-release-change__section_ynj_414_d1c} Quando artefatos e pacotes são registrados de uma ferramenta de origem em ServiceNow, elas são frequentemente encenadas no sn_devops_artifact_stagingenquanto os dados necessários restantes para a criação e vinculação desses objetos são recebidos de eventos de entrada ou obtidos por DevOpsfluxos. Na maioria das vezes, esses registros de preparação são processados em poucos segundos. Mas pode haver casos em que os dados necessários nunca são recebidos, portanto, esses registros podem ser deixados ociosos. . Descrição o campo na tabela abaixo contém um resumo dos detalhes ausentes nesses casos para ajudar no monitoramento mais fácil. Nota: É recomendável ter nomes de artefato exclusivos para compilações de versão, ou seja, nomes de artefato diferentes para compilações executadas em compilações de ramificações diferentes. {#using-dev-ops-release-change__table_gf4_kd4_d1c__entry__5} | Tipo de fase | Código de preparação | Quando isso pode ocorrer | Estado final? | Descrição | |-|-|-|-|-| | create_package_association | WAITING_FOR_OTHER_STAGED_REQUESTS | Durante uma chamada de registro de pacote, quando a execução da tarefa de origem da chamada é encontrada no sistema e pós-processada, mas nem todas as versões de artefato passadas na carga de artefatos foram encontradas no sistema. | Não | Sua solicitação de registro de pacote está pendente pelo seguinte motivo: A execução de tarefa encontrada para associação (TE00012345) e o sinalizador de pós-processamento está definido como verdadeiro, mas nem todas as versões de artefato foram encontradas. Contagem total de artefatos: 2 | | create_package_association | TASK_EXEC_POST_PROCESSING_PENDING | Durante uma chamada de registro de pacote, quando a execução da tarefa de origem da chamada é encontrada no sistema, mas ainda não foi pós-processada. Ou seja, o evento webhook concluído para esta execução de tarefa ainda não foi processado. | Não | Sua solicitação de registro de pacote está pendente pelo seguinte motivo: Execução de tarefa encontrada para associação (TE00012345), mas o sinalizador de pós-processamento concluído não está definido como verdadeiro. Contagem total de artefatos: 2 | | create_package_association | NO_TASK_EXECUTION_FOUND | Durante uma chamada de registro de pacote, quando a execução da tarefa de onde a chamada se originou ainda não foi encontrada no sistema. | Não | Sua solicitação de registro de pacote está pendente pelo seguinte motivo: A execução da tarefa não foi encontrada para associação (pipelineName: TestPipeline, stageName: Pacote, taskExecutionNumber: 18). Contagem total de artefatos: 2 | | create_package | VERSION_NOT_FOUND | Durante uma chamada de registro de pacote, quando a versão do artefato aprovada na carga de artefatos ainda não foi encontrada no sistema. | Não | Sua solicitação de registro de pacote está pendente pelo seguinte motivo: Versão do artefato não encontrada (nome TestArtefact, versão 2,5, repositoryName TestRepo, pipelineName, stageName Pacote, taskExecutionNumber: 18). Contagem de artefatos: 1 de 2 | | create_package | VERSION_NOT_FOUND | Durante uma chamada de registro de pacote, quando a versão do artefato não é passada na carga de artefatos, mas contém um taskExecutionSysId ou (pipelineName, stageName, taskExecutionNumber) que pode ser usado para pesquisar o registro de execução da tarefa, que, nesse caso, é encontrado e pós-processado, mas não tem nenhum registro de versão de artefato associado. | Não | Sua solicitação de registro de pacote está pendente pelo seguinte motivo: A versão do artefato não está disponível na carga e não foi encontrada usando os detalhes de execução da tarefa (nome TestArtifact, versão 2,5, repositoryName TestPipeline, stageName Pacote, taskExecution 18) (TE00012345). Contagem de artefatos: 1 de 2 | | create_package | TASK_EXEC_POST_PROCESSING_PENDING | Durante uma chamada de registro de pacote, quando a versão do artefato não é passada na carga de artefatos, mas contém um taskExecutionSysId ou (pipelineName, stageName, taskExecutionNumber) que pode ser usado para pesquisar o registro de execução da tarefa, que, nesse caso, foi encontrado, mas ainda não foi pós-processado. | Não | Sua solicitação de registro de pacote está pendente pelo seguinte motivo: A versão do artefato não está disponível na carga e a execução de tarefa foi encontrada para associação, mas o sinalizador de pós-processamento concluído não está definido como verdadeiro (nome TestArtifact, versão 2,5, repositoryName TestRepo, pipelineName, stageName Pacote, taskExecution 18) (TE00012345). Contagem de artefatos: 1 de 2 | | create_package | NO_TASK_EXECUTION_FOUND | Durante uma chamada de registro de pacote, quando a versão do artefato não é passada na carga de artefatos, mas contém um taskExecutionSysId ou (pipelineName, stageName, taskExecutionNumber) que pode ser usado para pesquisar o registro de execução da tarefa, que, nesse caso, não foi encontrado. | Não | Sua solicitação de registro de pacote está pendente pelo seguinte motivo: A versão do artefato não está disponível na carga e a execução da tarefa também não foi encontrada para associação (nome TestArtifact, versão 2,5, repositoryName TestPipeline, stageName Pacote, taskExecutionNumber: 18). Contagem de artefatos: 1 de 2 | | create_package | WAITING_FOR_OTHER_STAGED_REQUESTS | Durante uma chamada de registro de pacote, quando a versão do artefato aprovada na carga de artefatos é encontrada no sistema, mas deve aguardar o processamento dos outros registros de preparação relacionados (incluindo os registros create_package ou create_package_association). | Não | Sua solicitação de registro de pacote está pendente pelo seguinte motivo: Versão do artefato encontrada, mas é preciso aguardar os registros de preparação do registro de pacote restantes. Contagem de artefatos: 1 de 2 | | register_artefact | TASK_EXEC_POST_PROCESSING_PENDING | Durante uma chamada de registro de artefato, quando a execução da tarefa de origem da chamada é encontrada no sistema, mas ainda não foi pós-processada. Este é o evento de webhook "Concluído" para esta execução de tarefa ainda não foi processado. | Não | Sua solicitação de registro de artefato está pendente pelo seguinte motivo: Versão do artefato criada e execução de tarefa encontrada para associação (TE00012345), mas o sinalizador de pós-processamento concluído não está definido como verdadeiro. | | register_artefact | NO_TASK_EXECUTION_FOUND | Durante uma chamada de registro de artefato, quando a execução da tarefa de origem da chamada ainda não foi encontrada no sistema. | Não | Sua solicitação de registro de artefato está pendente pelo seguinte motivo: Versão do artefato criada, mas a execução da tarefa não foi encontrada para associação (pipelineName: TestPipeline, stageName: Pacote, taskExecutitionNumber: 18). | | register_artefact | VERSÃO_ALREADY_REGISTERED | Durante uma chamada de registro de artefato, quando a versão do artefato fornecida na carga de artefatos para um determinado artefato e repositório já existe no sistema. | Sim (ignorado) | Sua solicitação de registro de artefato foi ignorada pelo seguinte motivo: A versão do artefato já foi registrada. | | register_artefact | NO_SUBFLOW_CONFIGURED | Durante uma chamada de registro de artefato, quando a versão do artefato não é fornecida na carga de artefatos, e o webhook e o subfluxo de pesquisa não devem encontrar o registro da versão do artefato. | Sim (ignorado) | Sua solicitação de registro de artefato foi ignorada pelo seguinte motivo: A versão do artefato não está disponível na carga. O webhook e o subfluxo de pesquisa não estão disponíveis. | | register_artefact | NO_TASK_EXECUTION_FOUND | Durante uma chamada de registro de artefato, quando a versão do artefato não é fornecida na carga de artefatos, mas o webhook é compatível e o registro da versão do artefato pode ser encontrado, mas a execução da tarefa de onde a chamada se originou ainda não foi encontrada no sistema. | Não | Sua solicitação de registro de artefato está pendente pelo seguinte motivo: Versão do artefato encontrada via webhook, mas a execução da tarefa não foi encontrada para associação (pipelinePipeline, stageName Pacote, taskExecutitionNumber: 18). | | register_artefact | TASK_EXEC_POST_PROCESSING_PENDING | Durante uma chamada de registro de artefato, quando a versão do artefato não é fornecida na carga de artefatos, mas o webhook é compatível e o registro da versão do artefato pode ser encontrado, e a execução da tarefa de onde a chamada se originou é encontrada no sistema, mas ainda não foi pós-processada. Ou seja, o evento webhook concluído para esta execução de tarefa ainda não foi processado. | Não | Sua solicitação de registro de artefato está pendente pelo seguinte motivo: Versão do artefato encontrada via webhook e execução de tarefa encontrada para associação (TE00012345), mas o sinalizador de pós-processamento concluído não está definido como verdadeiro. | | register_artefact | NO_TASK_EXECUTION_FOUND | Durante uma chamada de registro de artefato, quando a versão do artefato não é fornecida na carga de artefatos, mas o subfluxo de pesquisa é compatível e o registro da versão do artefato pode ser encontrado, mas a execução da tarefa de onde a chamada se originou ainda não foi encontrada no sistema. | Não | Sua solicitação de registro de artefato está pendente pelo seguinte motivo: Versão do artefato encontrada por meio de pesquisa, mas a execução da tarefa não foi encontrada para associação (pipelinePipeline TestPipeline, stageName Pacote, taskExecutionNumber: 18). | | register_artefact | TASK_EXEC_POST_PROCESSING_PENDING | Durante uma chamada de registro de artefato, quando a versão do artefato não é fornecida na carga de artefatos, mas o subfluxo de pesquisa é compatível e o registro da versão do artefato pode ser encontrado, e a execução da tarefa de onde a chamada se originou é encontrada no sistema, mas ainda não foi pós-processada. Ou seja, o evento webhook concluído para esta execução de tarefa ainda não foi processado. | Não | Sua solicitação de registro de artefato está pendente pelo seguinte motivo: Versão do artefato encontrada por meio de pesquisa e execução de tarefa encontrada para associação (TE00012345), mas o sinalizador de pós-processamento concluído não está definido como verdadeiro. | | register_artefact | ERROR_CALLING_SUBFLOW | Durante uma chamada de registro de artefato, quando a versão do artefato não é fornecida na carga de artefatos e o subfluxo de pesquisa é compatível, mas a versão do artefato não foi encontrada. | Sim (ignorado) | Sua solicitação de registro de artefato foi ignorada pelo seguinte motivo: Versão do artefato não encontrada pelo subfluxo de pesquisa. | | register_artefact | ERROR_CALLING_SUBFLOW | Durante uma chamada de registro de artefato, quando a versão do artefato não é fornecida na carga de artefatos e o subfluxo de pesquisa é compatível, mas não foi possível encontrar a versão do artefato devido a um erro no subfluxo. | Sim (ignorado) | Sua solicitação de registro de artefato foi ignorada pelo seguinte motivo: Versão do artefato não encontrada pelo subfluxo de pesquisa devido a um erro (consulte os logs do DevOps para obter detalhes adicionais). | | register_artefact | ERROR_CALLING_SUBFLOW | Durante uma chamada de registro de artefato, quando a versão do artefato não é fornecida na carga de artefatos e o subfluxo de pesquisa é compatível, mas não foi executado porque o registro de artefato primário não foi encontrado no sistema. | Sim (ignorado) | Sua solicitação de registro de artefato foi ignorada pelo seguinte motivo: Artefato não encontrado. | [ ] {#using-dev-ops-release-change__table_gf4_kd4_d1c} * **[Confirmações incluídas em DevOpssolicitação de mudança](https://servicenow-prod.fluidtopics.net/s~eniFAInw0sAmOFBYE05A)** . DevOpso pacote de artefato e suas versões de artefato associadas são usados para determinar quais confirmações estão incluídas em um DevOpsmudança.