故障排除

JFrog平台

JFrog产品安装程序是如何hth华体会最新官方网站打包的?

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

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

如何修改JFrog产品的默认数据目录路径?hth华体会最新官方网站

根据安装程序类型:

RPM / Debian安装程序:在变量中设置数据目录路径JF_PRODUCT_VAR到自定义数据文件夹并启动服务。将系统环境变量设置为指向系统环境变量文件中的自定义位置。看到系统环境变量．
归档段r:默认数据目录为unzip-location /var．您可以将此目录符号链接到您想要的任何文件夹。
Docker合成安装程序:设置JF_ROOT_DATA_DIR中的变量.env与安装程序一起打包的文件。

如何监控平台的产品运行状况?hth华体会最新官方网站

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

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

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

我应该使用什么日志来调试我的环境?

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

如何定制我的JAVA_OPTS?

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

如何自定义应用程序端口?

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

打开Artifactory$ JFROG_HOME / artifactory / var / etc / system.yaml文件。
在artifactory部分下添加或编辑新的端口键。
```
Artifactory: port: <您的新端口，例如:8089>
```

system.full-template.yaml

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

访问服务

对于“java.lang”抛出异常。提供的私钥与最新私钥指纹不匹配"

症状

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

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

导致

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

决议

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

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

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

创建一个名为bootstrap.reset_root_keys下ARTIFACTORY_HOME /访问/ etc /美元
重启Artifactory。
验证美元ARTIFACTORY_HOME /日志/ artifactory.log或$ ARTIFACTORY_HOME / /日志/ access.log访问文件显示如下条目:

**************************************************************** *** 根私人的跳过验证指纹  *** **************************************************************** *** 私钥指纹将会被覆盖掉  **************** ****************************************************************

SSL / TLS问题

解决SSL/TLS问题

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

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

反向代理问题

ReverseProxy读错误

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

访问令牌

为什么我生成的访问令牌不工作?

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

高可用性

x光

如果我输入错误，我如何纠正主节点名称/ip ?

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

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

洞察力

安装

在elasticsearch日志中超过泛洪水位[95%]或在insight-executor日志中索引只读/允许删除

导致	存储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。

调试日志配置

为Insight服务器启用logback调试日志记录功能

导致

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

决议

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

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

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

洞察趋势Displa应

Insight趋势不显示，并显示500个错误

导致

使用不正确的Elasticsearch索引。

决议

登录Insight容器。

禁用AUTO_CREATE。

curl -H 'Content-Type:application/json' -XPUT localhost:8082/elasticsearch/_cluster/settings -d'{"persistent":{"action. json "auto_create_index”:“false”}}’-uadmin: admin

在Elasticsearch中删除索引:

curl -XDELETE http://localhost:8082/elasticsearch/active_request_data -uadmin:admin

在Elasticsearch中删除索引:

curl -XDELETE http://localhost:8082/elasticsearch/active_metrics_data -uadmin:admin

删除模板。

curl -X DELETE localhost:8082/elasticsearch/_template/request_logs_template_7 -uadmin:admin

删除模板。

curl -X DELETE localhost:8082/elasticsearch/_template/metrics_insight_template_7 -uadmin:admin

停止的洞察力。
开始了解。

管道

安装

在安装过程中无法连接到Docker守护进程

症状

当运行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

节点初始化

必须启用Windows容器。

症状

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

导致

节点没有启用容器。

决议

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

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

命令“node”不被识别

症状	在初始化一个新节点时，输出中的一个错误指出`节点`未找到。初始化失败。
导致	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—force`或`git变基`，这会删除提交并导致管道不运行。
决议	: 重置资源，然后再次触发管道。注意，如果管道中有几个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`
导致	在管道执行同步之后，不应该修改步骤的类型，因为它可能导致管道同步错误。
决议	虽然不推荐，但如果您确实想更改步骤的类型，请执行以下步骤: 更改步骤的名称和类型等待管道同步同步完成后，将步骤的名称更改为旧名称

错误: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在不同的亲和群体中

内容

空间工具