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=[***]

构建工具集成示例

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>[***]</url>
    </repository>
  </repositories>
</settings>

Gradle配置生成

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

groovy
allprojects {
  repositories {
    maven {
      url "[***]"
      credentials {
        username System.getenv("ATLASSIAN_USERNAME")
        password System.getenv("ATLASSIAN_PASSWORD")
      }
    }
  }
}

配置参数说明

环境变量	描述	是否必填	默认值
`ATLASSIAN_USERNAME`	Atlassian账号用户名/***	是	-
`ATLASSIAN_PASSWORD`	Atlassian账号密码或API Token	是	-
`BUILD_TOOL`	目标构建工具类型	否	`ALL`（支持`MAVEN`/`GRADLE`/`NPM`/`ALL`）
`REPO_URL`	自定义仓库URL	否	`[***]`
`CONFIG_OUTPUT_PATH`	配置文件输出目录	否	工具默认配置目录（如`~/.m2`、`~/.gradle`）

注意事项

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生成所有支持工具的配置