atlassian/artifactory-sidekick

Atlassian软件包仓库构建工具配置镜像

镜像概述

本Docker镜像旨在帮助开发和构建环境快速配置各类构建工具（如Maven、Gradle、npm等），以正确访问Atlassian官方软件包仓库packages.atlassian.com。通过预配置仓库访问规则及认证机制，解决手动配置复杂、权限管理繁琐等问题，确保构建工具能高效拉取Atlassian相关依赖包。

核心功能与特性

• 自动仓库配置：内置针对packages.atlassian.com的仓库访问规则，无需手动编写配置文件
• 多构建工具支持：兼容主流构建工具（Maven、Gradle、npm、yarn等）
• 认证集成：支持通过环境变量注入Atlassian账号凭证，实现安全访问
• 轻量级设计：基于官方构建工具镜像优化，减少冗余依赖，缩短启动时间
• 跨环境一致性：确保开发、测试、CI/CD等不同环境中仓库配置统一

使用场景

• Atlassian组件开发：基于Jira、Confluence等Atlassian产品开发插件时拉取依赖包
• CI/CD流水线：在Jenkins、GitLab CI等持续集成环境中快速配置构建依赖源
• 多团队协作：统一团队内构建工具对Atlassian仓库的访问配置，减少环境差异
• 离线环境部署：结合镜像缓存机制，在网络受限环境中复用已配置的仓库访问能力

使用方法与配置说明

基本使用

直接运行容器

bash
docker run --rm \
  -e ATLASSIAN_USERNAME=<your-atlassian-username> \
  -e ATLASSIAN_PASSWORD=<your-atlassian-api-token> \
  atlassian/package-repo-config

与构建工具集成（以Maven为例）

bash
docker run --rm \
  -v $(pwd):/app \
  -w /app \
  -e ATLASSIAN_USERNAME=<username> \
  -e ATLASSIAN_PASSWORD=<api-token> \
  atlassian/package-repo-config \
  mvn clean install

docker-compose配置示例

yaml
version: '3.8'
services:
  build-env:
    image: atlassian/package-repo-config
    volumes:
      - ./project:/app
    working_dir: /app
    environment:
      - ATLASSIAN_USERNAME=${ATLASSIAN_USERNAME}
      - ATLASSIAN_PASSWORD=${ATLASSIAN_PASSWORD}
      - BUILD_TOOL=MAVEN
      - REPO_URL=https://packages.atlassian.com/maven-public

构建工具集成示例

Maven配置生成

容器会自动生成settings.xml并注入到~/.m2/目录，内容示例：

xml
<settings>
  <servers>
    <server>
      <id>atlassian-public</id>
      <username>${env.ATLASSIAN_USERNAME}</username>
      <password>${env.ATLASSIAN_PASSWORD}</password>
    </server>
  </servers>
  <repositories>
    <repository>
      <id>atlassian-public</id>
      <url>https://packages.atlassian.com/maven-public</url>
    </repository>
  </repositories>
</settings>

Gradle配置生成

自动在~/.gradle/init.d/目录创建仓库配置脚本：

groovy
allprojects {
  repositories {
    maven {
      url "https://packages.atlassian.com/maven-public"
      credentials {
        username System.getenv("ATLASSIAN_USERNAME")
        password System.getenv("ATLASSIAN_PASSWORD")
      }
    }
  }
}

配置参数说明

注意事项

• API Token安全：建议使用Atlassian账号的API Token（而非明文密码），通过Atlassian Account Security生成
• 权限最小化：为容器分配的Atlassian账号应仅具备仓库只读权限，遵循最小权限原则
• 缓存优化：在CI/CD环境中可挂载构建工具缓存目录（如~/.m2/repository）以加速依赖拉取

常见问题

• Q: 构建工具提示无权限访问仓库？
  A: 检查ATLASSIAN_USERNAME和ATLASSIAN_PASSWORD是否正确，确认账号拥有packages.atlassian.com访问权限

• Q: 容器未生成对应构建工具的配置文件？
  A: 确认BUILD_TOOL参数是否包含目标工具，或使用默认值ALL生成所有支持工具的配置