Issue

Welcome to use issue tracker to give us :bowtie::

• feedbacks - what you would like to have;
• usage tips - what usages you have found splendid;
• experiences - how you use Arthas to do effective troubleshooting;

Documentation

• Under site/docs/.

Online Tutorials

Please refer to README.MD at killercoda branch

Developer

• Arthas runtime supports JDK6+
• It is recommended to use JDK8 to compile, and you will encounter problems when using a higher version. Reference https://github.com/alibaba/arthas/tree/master/.github/workflows
• If you encounter jfr related problems, it is recommended to use 8u262 and later versions of openjdk8 or zulu jdk8, https://mail.openjdk.org/pipermail/jdk8u-dev/2020-July/012143.html

Local Installation

Note: After modifying arthas-vmtool related codes, the packaging results need to be manually copied to the lib/ path of this repo, and will not be copied automatically.

Recommend to use as-package.sh to package, which will auto-install the latest Arthas to local ~/.arthas and when debugging, Arthas will auto-load the latest version.

• To support jni, cpp compiling environment support is required
• mac needs to install xcode
• windows need to install gcc

F.Y.I

1. when using as.sh to start Arthas, it will get the latest version under ~/.arthas/lib;
2. when as-package.sh packaging, it will get the version from pom.xml and suffix it with the current timestamp e.g. 3.0.5.20180917161808.

You can also use ./mvnw clean package -DskipTests to package and generate a zip under packaging/target/ but remember when as.sh starts, it load the version under ~/.arthas/lib.

Start Arthas in specified version

When there are several different version, you can use --use-version to specify the version of Arthas to start your debug.

./as.sh --use-version 3.0.5.20180919185025

Tip: you can use --versions to list all available versions.

./as.sh --versions

Debug

• Debug Arthas In IDEA

Packaging All

• when packaging the whole project (Packaging All), you need to execute:

  ./mvnw clean package -DskipTests -P full

Issue

欢迎在issue里对arthas做反馈，分享使用技巧，排查问题的经历。

• https://github.com/alibaba/arthas/issues

改进用户文档

用户文档在site/docs/目录下，如果希望改进arthas用户文档，欢迎提交PR。

改进在线教程

请参考killercoda 分支下的说明

开发者相关

• Arthas运行支持JDK6+
• 建议使用JDK8来编译，使用高版本会遇到问题。参考 https://github.com/alibaba/arthas/tree/master/.github/workflows
• 如果遇到jfr相关问题，建议使用8u262及之后的高版本 openjdk8 或者zulu jdk8， https://mail.openjdk.org/pipermail/jdk8u-dev/2020-July/012143.html

安装到本地

注意： 修改arthas-vmtool相关代码后，打包结果需要手动复制到本仓库的 lib/ 路径下，不会自动复制。

本地开发时，推荐执行as-package.sh来打包，会自动安装最新版本的arthas到~/.arthas目录里。debug时会自动使用最新版本。

• 代码里要编译jni，需要cpp编译环境支持
• mac需要安装xcode
• windows需要安装gcc

as.sh在启动时，会对~/.arthas/lib下面的目录排序，取最新的版本。as-package.sh在打包时，会取pom.xml里的版本号，再拼接上当前时间，比如： 3.0.5.20180917161808，这样子排序时取的就是最新的版本。

也可以直接 ./mvnw clean package -DskipTests打包，生成的zip在 packaging/target/ 下面。但是注意as.sh启动加载的是~/.arthas/lib下面的版本。

启动指定版本的arthas

本地开发时，可能会产生多个版本，可以用 --use-version 参数来指定版本，比如

./as.sh --use-version 3.0.5.20180919185025

可以用--versions参数来列出所有版本：

./as.sh --versions

Debug

• Debug Arthas In IDEA

全量打包

• 全量打包时，需要配置下面的参数：

  ./mvnw clean package -DskipTests -P full

Release Steps

发布release版本流程：

• 如果 arthas-vmtool 有更新，则需要手动触发action，构建后会把新的动态库文件提交到 lib 目录。 https://github.com/alibaba/arthas/actions/workflows/build-vmtool.yaml

• 修改as.sh里的版本，最后修改日期， Bootstrap.java里的版本，Dockerfile里的版本

• 修改本地的maven settings.xml

• mvn clean deploy -DskipTests -P full -P release

• 到 https://oss.sonatype.org/ 上，“Staging Repositories”然后close掉自己的，再release

• 发布后，可以到这里查看是否同步到仓库里了： https://repo1.maven.org/maven2/com/taobao/arthas/arthas-packaging/

• 发布完maven仓库之后，需要到阿里云的仓库里检查是否同步，有可能有延时

  比如下载地址： https://maven.aliyun.com/repository/public/com/taobao/arthas/arthas-packaging/3.x.x/arthas-packaging-3.x.x-bin.zip

  版本号信息地址： https://maven.aliyun.com/repository/public/com/taobao/arthas/arthas-packaging/maven-metadata.xml

• 打上tag，push tag到仓库上

• 需要更新 gh-pages 分支下面的 arthas-boot.jar/math-game.jar/as.sh ，下载 doc.zip，解压覆盖掉文档的更新

• 需要更新docker镜像，push新的tag：https://hub.docker.com/r/hengyunabc/arthas/tags?page=1&ordering=last_updated

  以 3.6.5 版本为例：

  docker buildx build . --build-arg ARTHAS_VERSION=3.6.5 --build-arg MIRROR=true -t hengyunabc/arthas:3.6.5 -t hengyunabc/arthas:latest --platform=linux/arm64,linux/amd64 --push 
  
  docker buildx build .  --build-arg ARTHAS_VERSION=3.6.5  --build-arg MIRROR=true -f Dockerfile-No-Jdk -t hengyunabc/arthas:3.6.5-no-jdk --platform=linux/arm64,linux/amd64  --push 

• 更新README.md，比如增加了新命令，要加上说明，更新wiki的链接

• 更新release页面的 issue信息，修改信息等

• 更新 https://arthas.aliyun.com/api/latest_version api

• 更新内部的版本