bobswiftapps/acli

Appfire CLI (ACLI) Docker镜像文档

!ACLI

概述

Appfire CLI（ACLI）前身为Atlassian CLI，是适用于各种Atlassian及其他应用的集成CLI家族，为高级用户、管理员、脚本编写者和DevOps开发者提供一致且可靠的自动化平台。它提供了便捷的方式来快速执行任务、实施业务流程或对各类流行应用进行通用自动化。这些CLI基于应用提供的远程API构建，提供了比底层产品API更易于使用的高级客户端API。详见ACLI。

我们使用"客户端"一词指代特定应用的支持，例如Jira客户端、Confluence客户端、Bitbucket客户端或Slack客户端等。所有客户端均包含在ACLI发行版和Docker镜像中。

ACLI Docker镜像提供了便捷的方式来快速安装客户端发行版并立即开始使用ACLI！从10.3.0版本开始，根据使用场景提供多种ACLI Docker镜像。所有镜像均包含ACLI且工作方式相同，但镜像中包含的内容有所不同，以尽可能方便特定DevOps和流水线使用场景。Appfire在内部将这些镜像用于集成测试流水线和相关自动化。同样从10.3.0及更高版本开始，镜像基于当前Ubuntu LTS版本构建，并包含一些对流水线和DevOps场景特别有用的额外工具，目前包括：git nano unzip。

镜像类型

• https://hub.docker.com/r/bobswiftapps/acli - ACLI优化发行版（Linux/amd64）。注意：10.3.0及更高版本不再包含Java JRE。
• https://hub.docker.com/r/bobswiftapps/acli-jre - ACLI优化发行版（Linux/amd64），包含来自https://hub.docker.com/_/eclipse-temurin%E7%9A%84Java 17 JRE。
• https://hub.docker.com/r/bobswiftapps/acli-jre - ACLI通用发行版，包含来自https://hub.docker.com/_/eclipse-temurin%E7%9A%84Java 17 JRE。

相关链接

• ACLI - 通用文档
• ACLI发行版 - 解释ACLI发行版及差异
• ACLI操作参考 - 每个客户端的参考和示例
• ACLI发行说明
• ACLI支持门户
• https://hub.docker.com/r/bobswiftapps/acli/
• ACLI Atlassian社区 - 问题和讨论

快速开始

要快速启动ACLI Docker实例，使用以下命令：

bash
$ docker run -ti bobswiftapps/acli:latest /bin/bash

bash-4.4# acli -a getClientInfo
Client name: cli, Client version: 10.6.0, Client build: 2023-01-25T11:20:33, Java: Substrate VM 17.0.4, OS: Linux 5.10.104-linuxkit

或者，直接运行CLI操作：

bash
$ docker run -ti bobswiftapps/acli:latest acli -a getClientInfo
Client name: cli, Client version: 10.6.0, Client build: 2023-01-25T11:20:33, Java: Substrate VM 17.0.4, OS: Linux 5.10.104-linuxkit

传递环境变量

bash
$ docker run -e examplegear='jira -s https://examplegear.atlassian.net -u anonymous' -ti bobswiftapps/acli:latest /bin/bash
bash-4.4# acli ${examplegear} -a getServerInfo
Jira version: 1001.0.0-SNAPSHOT, build: 100207, time: 10/7/22, 3:33 AM, description: Appfire Example Gear Jira, url: https://examplegear.atlassian.net

使用环境文件传递环境变量

bash
$ cat .env
examplegear=jira -s https://examplegear.atlassian.net -u anonymous
examplegear_confluence=confluence -s https://examplegear.atlassian.net/wiki -u anonymous

bash
$ docker run --env-file=.env -ti bobswiftapps/acli:latest /bin/bash
bash-5.0# acli $examplegear -a getServerInfo
Jira version: 1001.0.0-SNAPSHOT, build: 100207, time: 10/7/22, 3:33 AM, description: Appfire Example Gear Jira, url: https://examplegear.atlassian.net
bash-5.0# acli $examplegear_confluence -a getServerInfo
Confluence version: 1000.0.0, build: d4f5af0175c86895f923fbf93e073a787e005e32, url: https://examplegear.atlassian.net/wiki

通过卷提供配置属性

从当前目录挂载到镜像的ACLI安装目录：

bash
docker run -v ${PWD}/acli.properties:/opt/acli/acli.properties -ti bobswiftapps/acli:latest

11.0.0版本之前，使用：

bash
docker run -v ${PWD}/acli.properties:/opt/atlassian-cli/acli.properties -ti bobswiftapps/acli:latest

版本控制

通过版本号标签使用特定版本的ACLI：bobswiftapps/acli:10.6.0。这将安装**10.6.0**版本，推荐用于生产环境。

或者，latest标签对应ACLI的最新稳定版本。因此bobswiftapps/acli:latest将使用最新发布的ACLI版本。注意：如果之前已使用latest安装，可能需要先更新本地镜像缓存：docker pull bobswiftapps/acli:latest。

对于最新EAP（早期访问计划）版本，使用**eap标签：bobswiftapps/acli:eap。这将安装当前开发中的最新SNAPSHOT版本。注意：如果之前已使用eap安装，应先更新本地缓存以获取最新SNAPSHOT镜像：docker pull bobswiftapps/acli:eap**。