云客户?
免费开始>
在MyJFrog >中升级
云有什么新>







概述

本页面提供用户遇到的常见问题的解决方法。

页面内容


JFrog平台

以下结构在所有JFrog产品中都是通用的。hth华体会最新官方网站

文件夹/文件名称

描述

箱子
包含安装程序的帮助程序脚本。
第三方
包含第三方软件。
<产品>
特定于产品的包(适用于非Docker Compose安装程序)
模板
Docker Compose模板(仅适用于Docker Compose安装程序)。
install.sh
主安装程序脚本(用于非Docker Compose安装程序)。
config.sh
主配置脚本(仅适用于Docker Compose安装程序)。
readme.md
读给我提供包细节的文件。

根据安装程序类型:

  • RPM / Debian安装程序:在变量中设置数据目录路径JF_PRODUCT_VAR到自定义数据文件夹并启动服务。将系统环境变量设置为指向系统环境变量文件中的自定义位置。看到系统环境变量

  • 归档段r:默认数据目录为unzip-location /var.您可以将此目录符号链接到您想要的任何文件夹。

  • Docker合成安装程序:设置JF_ROOT_DATA_DIR中的变量.env与安装程序一起打包的文件。

建议在特定的JFrog产品路由器节点上运行健康检查,该节点连接到所有节点的微服务。这将为您提供该节点的最新运行状况信息。

例如,平台运行状况检查REST API

GET /路由器/ api / v1 /系统/健康

每个微服务都有自己的服务日志。但是,建议通过使用启动调试过程console.log,该日志收集了节点下所有产品的所有业务日志。hth华体会最新官方网站了解更多>

JFrog Artifactory,洞察力和发行版都捆绑在Java 11中。要自定义Java运行时,请配置shared.extraJavaOptssystem.yaml

每个JFrog产品使用的默认端口可以在产品中修改system.yaml文件。
例如,要设置Artifactory运行在不同的端口上(而不是默认的8081端口),执行以下操作:

  1. 打开Artifactory$ JFROG_HOME / artifactory / var / etc / system.yaml文件。
  2. 在artifactory部分下添加或编辑新的端口键。

    Artifactory: port: <您的新端口,例如:8089>

system.full-template.yaml

中提供了所有不同配置值(包括应用程序端口)的示例美元JFROG_HOME / <产品> / var / etc / system.full-template.yaml文件。


访问服务

症状

在启动过程中,Artifactory启动失败,并抛出一个错误:

illegalstateexception:提供的私钥与最新私钥指纹不匹配。
导致

Artifactory尝试验证和比较驻留在Artifactory数据库和本地文件系统中的访问密钥指纹。如果密钥不匹配,将抛出上述异常以及不匹配的指纹id。
这可能发生在试图升级/安装Artifactory期间。

决议

按照以下步骤,确保您信任的圈子中的所有实例都具有相同的私钥和根证书:

键旋转将使任何发出的访问令牌无效

下面的过程将创建新的密钥对,从而使任何现有的访问令牌无效。

    1. 创建一个名为bootstrap.reset_root_keysARTIFACTORY_HOME /访问/ etc /美元
    2. 重启Artifactory。
    3. 验证美元ARTIFACTORY_HOME /日志/ artifactory.log$ ARTIFACTORY_HOME / /日志/ access.log访问文件显示如下条目:
    **************************************************************** *** 根私人的跳过验证指纹  *** **************************************************************** *** 私钥指纹将会被覆盖掉  **************** ****************************************************************



SSL / TLS问题

下面是一些Java选项,可以帮助解决Artifactory中的SSL/TLS问题:

  • Djavax.net.debug =: ssl握手
  • Djava.security.debug = certpath提供者

反向代理问题

错误“httputil: ReverseProxy读取错误期间主体复制错误”显示在日志(控制台,应用程序日志)中。错误源于treafik,和那里是否没有观察到与这些错误相关的实际影响



访问令牌

症状 使用访问令牌进行身份验证时出现“令牌验证失败".
导致 在Artifactory 5.4中改变了访问令牌的实现。该更改是向后兼容的,因此使用早期版本的Artifactory创建的令牌可以在新版本中进行身份验证,但反之则不然。在5.4或更高版本中创建的令牌无法通过5.4之前的版本进行身份验证。
决议 要么升级旧的Artifactory实例,要么确保只使用旧实例创建访问令牌

高可用性

x光

HA安装后,如果需要调整备节点上的主节点名称和IP,建议重新运行安装包装器脚本。也可手动修改以下文件:

RPM或Debian安装
  1. $ JFROG_HOME / x光/ var / etc / system.yaml
Docker Compose安装
  1. $ JFROG_HOME / x光/ var / etc / system.yaml
  2. <安装文件夹> / .env
  3. rabbitmq JFROG_HOME美元/ x光/ app /第三方/ / rabbitmq.conf

洞察力

安装

导致
存储Elasticsearch数据的磁盘已超过95%的存储空间
决议

1.停止服务。

2.清除用于存储Elasticsearch数据的磁盘空间。

3.启动服务。

4.更改Elasticsearch索引设置为RW(读写)。

curl -u<用户名>:<密码> -XPUT -H "Content-Type: application/json" http://localhost:9200/_all/_settings -d '{"index.blocks. xml "read_only_allow_delete”:零}’

Elasticsearch内部的默认用户名和密码是admin。

调试日志配置

导致
从版本4开始。xml有不同的方式来启用调试日志记录。
决议

设置Insight日志用于调试日志。
在“$JFROG_HOME/var/opt/jfrog/mc/etc/insight/logback.xml”文件中,m .单击“确定”修改记录器名称行如下所示:

<记录器name = "org.jfrog.insight”水平= "调试" / >

对日志配置所做的更改将在几秒钟内重新加载,而不需要重新启动。

洞察趋势Displa

导致
使用不正确的Elasticsearch索引。
决议
  1. 登录Insight容器。

  2. 禁用AUTO_CREATE。

    curl -H 'Content-Type:application/json' -XPUT localhost:8082/elasticsearch/_cluster/settings -d'{"persistent":{"action. json "auto_create_index”:“false”}}’-uadmin: admin
  3. 在Elasticsearch中删除索引:

    curl -XDELETE http://localhost:8082/elasticsearch/active_request_data -uadmin:admin
  4. 在Elasticsearch中删除索引:

    curl -XDELETE http://localhost:8082/elasticsearch/active_metrics_data -uadmin:admin
  5. 删除模板。

    curl -X DELETE localhost:8082/elasticsearch/_template/request_logs_template_7 -uadmin:admin
  6. 删除模板。

    curl -X DELETE localhost:8082/elasticsearch/_template/metrics_insight_template_7 -uadmin:admin
  7. 停止的洞察力。

  8. 开始了解。




管道

安装

症状

当运行Pipelines install时,您将收到以下消息:

#设置平台配置  ################################################## 不能连接到码头工人在unix守护进程:/ / / var /运行/ docker.sock。docker守护进程正在运行吗?
导致

Docker服务未运行。这可以通过运行来验证码头工人信息

决议

重新启动Docker服务:

$ systemctl stop docker $ systemctl start docker OR $ systemctl restart docker OR $ service docker restart OR $ service docker stop $ service docker start

节点初始化

症状
check_win_containers_enabled:必须启用Windows容器。请安装该功能,重新启动计算机并再次运行此脚本。
导致

节点没有启用容器。

决议

为Windows启用容器。在PowerShell中以提升的权限运行以下命令,然后重新启动计算机。

> Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
症状

在初始化一个新节点时,输出中的一个错误指出节点未找到。初始化失败。

导致

NodeJS已经安装,但是配置错误。错误很可能是因为在路径中没有找到它。

决议

卸载NodeJS并允许构建节点初始化重新安装。

如果NodeJS最初是作为节点初始化的一部分安装的,那么以下命令应该可以工作。

Ubuntu、CentOS、RHEL $ sudo rm -rf /usr/local/bin/node $ sudo rm -rf /usr/local/lib/node_modules/npm/ Windows > choco卸载nodejs

管道错误消息

本节列出常见的管道错误消息、可能的原因以及解决错误的一些建议。如果您在修复这些错误时遇到困难,向支持部门提交申请,以便进一步调查。

错误:没有获取所有资源版本

错误
reqKick|executeStep|step|prepData|jFrogPipelinesSessionId:28be9c21-4ad6-4e3d-9411-7b9988535fd1|_getResourceVersions,所有资源版本都不获取。请求的资源版本:16;接收到的资源版本:[]
导致

在触发运行之后,但在开始运行之前,管道中的一个或多个资源被重置。2022世界杯阿根廷预选赛赛程因此,在获取与运行相关的资源时,资源版本将作为空数组2022世界杯阿根廷预选赛赛程返回。

决议

重新运行管道。

当资源被重置时,它会清除资源版本历史记录,并将其重置为单个版本,现在认为是最新版本。此版本用于新运行。

错误:致命:引用不是树

错误
致命:参考不是树:679e2fc3c2590f7dbaf64534a325ac60b4dc8689
导致

这可能是吸毒造成的Git push—forcegit变基,这会删除提交并导致管道不运行。

决议

:

  • 重置资源,然后再次触发管道。注意,如果管道中有几个GitRepo资源,则需要为所有资源执行此操作。2022世界杯阿根廷预选赛赛程

  • 推送另一个提交,以便自动更新所有资源。2022世界杯阿根廷预选赛赛程

错误:为节点创建pvc失败

错误
日志含义为节点创建pvc失败
导致

要么Kubernetes配置没有权限创建持续数量索赔(PVC)资源或管道无法连接到所提供的Kubernetes主机服务器。

决议

查看Kubernetes配置并验证Kube配置在创建Kubernetes集成足够的权限。

错误:SCM提供者凭证没有足够的权限

错误
为集成“”提供的凭据没有足够的权限。确保凭证存在,并具有提供者的正确权限:github。
导致

创建集成时提供的凭据(用户名和/或令牌)不正确或不充分。

决议

确保为SCM提供者提供的凭证是正确的,并且具有足够的权限。

错误:SCM提供者URL无效

错误
为集成“”提供的URL无效。为SCM提供程序提供一个有效的URL,然后重试。
导致

创建集成时提供的SCM URL是不正确的。

决议

确保为SCM提供者提供的URL是正确的。

错误:SCM提供者存储库路径无效

错误
存储库路径“”无效或不存在。确保存储库路径存在,并且具有正确的集成权限:
导致

为SCM提供者提供的存储库路径不正确或不存在

决议

确保为SCM提供者提供的存储库名称是正确的。

错误:无法更新步骤类型

错误
step 中的Type不能从更新到

例子建立/ ci /管道。yml:类型不能在步骤e2e_local_tests中从Bash更新到Matrix

导致

在管道执行同步之后,不应该修改步骤的类型,因为它可能导致管道同步错误。

决议

虽然不推荐,但如果您确实想更改步骤的类型,请执行以下步骤:

  1. 更改步骤的名称和类型
  2. 等待管道同步
  3. 同步完成后,将步骤的名称更改为旧名称

错误:Ubuntu 16.04不支持

错误
Ubuntu_16.04已停止支持。请升级到更高的版本。
导致

Ubuntu Linux 16.04 LTS于2021年4月30日结束了其五年的LTS窗口,不再受其供应商的支持。因此,管道不再支持现有的Ubuntu 16节点池。

决议
  • 动态节点池:现有的Ubuntu 16动态池将自动迁移到Ubuntu 18,前提是这些动态池是用默认的构建平面映像创建的。如果你有的话自定义Ubuntu 16节点池,它们必须手动迁移到Ubuntu 18或更高版本。
  • 静态节点池:将现有的所有Ubuntu 16静态节点池升级到Ubuntu 18或更高版本。

有关支持的Ubuntu版本的信息,请参见系统需求矩阵

错误:CentOS 8.0不支持

错误
CentOS 8的支持已经结束。请更换操作系统到其他支持的版本。支持的版本列表请参见系统要求。
导致

CentOS 8。该产品将于2021年12月到期,供应商不再支持该产品。因此,管道不再支持现有的CentOS 8节点池。

决议
  • 动态节点池:现有的CentOS 8。x动态池将自动迁移到CentOS 7.0,前提是这些动态池是用默认的构建平面映像创建的。如果你有的话自定义CentOS 8。X节点池,它们必须手动迁移到CentOS 7.0或其他操作系统。
  • 静态节点池:升级到管道的下一个主要版本后,要么删除任何CentOS 8。x节点池或将机器镜像修改为不同的操作系统。

支持的操作系统版本列表请参见系统需求

postHook返回错误422

错误
Webhook创建失败的路径:userName/repoName和集成:myGithub与err: postHook返回错误422 userName/repoName
导致

这通常是太多的webhook的结果。GitHub允许每个存储库有20个webhook。

决议

在GitHub中,进入设置|人则标签为相关的存储库和删除所有失败的webhook。

错误:连接不成功

错误
连接不成功
导致

这条消息出现的原因之一是时间为集成提供的Artifactory/Distribution URL不正确。

决议

验证为集成提供的Artifactory/Distribution URL是否正确。如果您发现它不正确,请更新URL并使用测试连接按钮进行验证,然后保存。

"cannotinterruptaffinityGroup"".">错误:step "" cannot interrupt affinityGroup ""。

错误
custupd_docker: step "bundle"不能中断affinityGroup "group1"。
导致

当管道中有多个步骤且中间步骤属于不同的亲和组时,就会发生这种情况。这会中断步骤的流程。

例如:依次有三个步骤,一步一个步骤B,步骤C一步一个而且步骤C是亲和团体的一部分吗A组,但步骤B是亲和团体的一部分吗B组

决议

在相同的亲和组中定义所有步骤及其依赖项。不应该有属于不同亲和组的任何中间步骤。

例如,做以下其中一件事:

  • 定义一步一个步骤B,步骤C在同一个亲和组
  • 定义一步一个而且步骤B在同一亲和力组,与步骤C在不同的亲和群体中
  • 定义一步一个在亲和团体中,与步骤B而且步骤C在不同的亲和群体中
  • 没有标签
版权所有©2023 JFrog Ltd。