故障排除

JFrog平台

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

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

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

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

根据安装程序类型:

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

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

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

例如，平台健康检查REST API。

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

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

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

如何自定义JAVA_OPTS?

JFrog Artifactory,洞察力和Distribution都与Java 11捆绑在一起。要自定义Java运行时，请配置shared.extraJavaOpts在system.yaml。

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

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

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

system.full-template.yaml

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

访问服务

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

症状

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

java.lang.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组件安装	$ 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. conf . conf "read_only_allow_delete”:零}’ Elasticsearch的默认用户名和密码为“admin”。

调试日志配置

为Insight服务器启用logback调试日志

导致

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

决议

将Insight日志配置为调试日志。
在$JFROG_HOME/var/opt/jfrog/mc/etc/insight/logback.xml文件中将记录器的名称行修改如下:

<记录器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守护进程

症状

当运行管道安装时，你会收到以下消息:

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

导致

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

决议

重新启动Docker服务:

$ systemctl stop $ systemctl start docker或$ systemctl restart docker或$ service docker restart或$ service docker stop $ service docker start

节点初始化

必须启用Windows容器。

症状

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

导致

该节点没有启用容器。

决议

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

Microsoft-Hyper-V -All > Enable-WindowsOptionalFeature -Online -FeatureName Containers -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世界杯阿根廷预选赛赛程回。
决议	重新运行管道。重置资源时，它将清除资源版本历史记录并将其重置为单个版本，该版本现在被认为是最新的。此版本用于新运行。

错误:fatal:引用不是树

错误	引用不是树: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 /管道。在步骤e2e_local_tests中，type不能从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。x的寿命将于2021年12月结束，其供应商不再支持。因此，管线不再支持现有的CentOS 8节点池。
决议	动态节点池:现有的CentOS 8。x动态池将自动迁移到CentOS 7.0，只要这些池是用默认构建平面映像创建的。如果你有的话自定义CentOS 8。X节点池，必须手动迁移到CentOS 7.0或其他操作系统。静态节点池:升级到管线的下一个主要版本后，要么删除任何CentOS 8。或将机器映像更改为其他操作系统。支持的操作系统版本列表请参见系统需求。

错误:postthook返回错误422

错误	同步钩子失败:Webhook创建失败的路径:userName/repoName和集成:myGithub与err: postHook返回错误422的userName/repoName
导致	这通常是太多webhook的结果。GitHub允许每个存储库20个webhook。
决议	在GitHub中，转到设置\|人则选项卡，删除所有失败的webhook。

错误:连接不成功

错误	连接不成功
导致	出现此消息的原因之一是为集成提供的Artifactory/Distribution URL不正确。
决议	验证为集成提供的Artifactory/Distribution URL是否正确。如果发现不正确，请更新URL并使用测试连接按钮进行验证，然后保存。

内容

空间工具