同步操作将从 Arthas/arthas 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
Welcome to use issue tracker to give us :bowtie::
Welcome PR to further improve English documentation.
Please refer to README.MD at tutorials/katacoda
java.lang.management.BufferPoolMXBean
.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
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.
F.Y.I
as.sh
to start Arthas, it will get the latest version under ~/.arthas/lib
;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
.
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
Arthas is using Sphinx to generate the static site
sphinx-maven-plugin
configured in site/pom.xml
sphinx-maven-plugin
executes by downloadingsphinx-binary/
when packaging the whole project (Packaging All), you need to execute:
./mvnw clean package -DskipTests -P full
欢迎在issue里对arthas做反馈,分享使用技巧,排查问题的经历。
用户文档在site/src/site/sphinx
目录下,如果希望改进arthas用户文档,欢迎提交PR。
英文文档在site/src/site/sphinx/en
目录下,欢迎提交翻译PR。
java.lang.management.BufferPoolMXBean
。建议使用JDK8来编译,使用高版本会遇到问题。参考 https://github.com/alibaba/arthas/tree/master/.github/workflows
本地开发时,推荐执行as-package.sh
来打包,会自动安装最新版本的arthas到~/.arthas
目录里。debug时会自动使用最新版本。
as.sh
在启动时,会对~/.arthas/lib
下面的目录排序,取最新的版本。as-package.sh
在打包时,会取pom.xml
里的版本号,再拼接上当前时间,比如: 3.0.5.20180917161808
,这样子排序时取的就是最新的版本。
也可以直接 ./mvnw clean package -DskipTests
打包,生成的zip在 packaging/target/
下面。但是注意as.sh
启动加载的是~/.arthas/lib
下面的版本。
本地开发时,可能会产生多个版本,可以用 --use-version
参数来指定版本,比如
./as.sh --use-version 3.0.5.20180919185025
可以用--versions
参数来列出所有版本:
./as.sh --versions
arthas是用sphinx来生成静态网站
在site/pom.xml
里配置了sphinx-maven-plugin
sphinx-maven-plugin
通过下载sphinx-binary/
来执行
全量打包时,需要配置下面的参数:
./mvnw clean package -DskipTests -P full
到 https://github.com/trustin/sphinx-binary/releases 下载对应版本的二进制文件,并在本地加上可执行权限。例如:
wget https://github.com/hengyunabc/sphinx-binary/releases/download/v0.4.0.1/sphinx.osx-x86_64 -o /tmp/sphinx.osx-x86_64
chmod +x /tmp/sphinx.osx-x86_64
./mvnw clean package -DskipTests -P full -Dsphinx.binUrl=file:/tmp/sphinx.osx-x86_64
发布release版本流程:
修改as.sh
里的版本,最后修改日期, Bootstrap.java
里的版本,Dockerfile里的版本
修改本地的maven settings.xml
mvn clean deploy -DskipTests -P full -P release
如果在下载 sphinx-binary 出错,参考上面的 全量打包 的说明。
到 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/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.1.0 版本为例:
docker build . --build-arg ARTHAS_VERSION=3.1.0 -t hengyunabc/arthas:3.1.0
docker tag hengyunabc/arthas:3.1.0 hengyunabc/arthas:latest
docker push hengyunabc/arthas:3.1.0
docker push hengyunabc/arthas:latest
docker build . --build-arg ARTHAS_VERSION=3.1.0 -f Dockerfile-No-Jdk -t hengyunabc/arthas:3.1.0-no-jdk
docker push hengyunabc/arthas:3.1.0-no-jdk
更新README.md,比如增加了新命令,要加上说明,更新wiki的链接
更新release页面的 issue信息,修改信息等
更新内部的版本
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。