借助GitHub Actions将Java Spring Boot项目Docker镜像上传至OCI的流水线示例请求

前置准备 #

在开始前，你需要完成以下配置：

• 在OCI控制台创建容器仓库（提前确定仓库名称和所在区域）
• 在GitHub仓库的Settings > Secrets and variables > Actions中添加以下机密变量：
  • OCI_TENANCY_OCID: OCI租户OCID
  • OCI_USER_OCID: OCI用户OCID
  • OCI_REGION: OCI区域（例如us-phoenix-1）
  • OCI_FINGERPRINT: API密钥的指纹
  • OCI_PRIVATE_KEY: OCI用户的API私钥内容（保留原始换行符）
  • OCI_REPOSITORY_NAME: 目标OCI容器仓库名称
  • OCI_COMPARTMENT_OCID: 容器仓库所在的 compartment OCID（若仓库在根租户可省略）

完整流水线脚本 #

将以下内容保存为.github/workflows/oci-docker-push.yml：

name: Build & Push Spring Boot Docker Image to OCI

on:
  push:
    branches: [ main ]
  release:
    types: [ published ]

jobs:
  build-and-push:
    runs-on: ubuntu-latest
    steps:
      # 1. 检出代码
      - name: Checkout code
        uses: actions/checkout@v4

      # 2. 设置JDK环境（匹配你的Spring Boot项目JDK版本）
      - name: Set up JDK 17
        uses: actions/setup-java@v4
        with:
          java-version: '17'
          distribution: 'temurin'
          cache: maven

      # 3. 打包Spring Boot应用（跳过测试加快构建）
      - name: Build Spring Boot JAR
        run: mvn clean package -DskipTests

      # 4. 配置OCI CLI凭证
      - name: Configure OCI CLI
        run: |
          mkdir -p ~/.oci
          echo "${{ secrets.OCI_PRIVATE_KEY }}" > ~/.oci/oci_api_key.pem
          chmod 600 ~/.oci/oci_api_key.pem
          cat > ~/.oci/config << EOF
          [DEFAULT]
          user=${{ secrets.OCI_USER_OCID }}
          fingerprint=${{ secrets.OCI_FINGERPRINT }}
          tenancy=${{ secrets.OCI_TENANCY_OCID }}
          region=${{ secrets.OCI_REGION }}
          key_file=~/.oci/oci_api_key.pem
          EOF

      # 5. 登录OCI容器仓库
      - name: Login to OCI Container Registry
        run: |
          oci registry auth login --region ${{ secrets.OCI_REGION }} --auth-token

      # 6. 构建Docker镜像
      - name: Build Docker image
        run: |
          # 生成镜像标签：优先用Release版本号，否则用Git提交SHA
          IMAGE_TAG=${{ github.event.release.tag_name || github.sha }}
          docker build -t ${{ secrets.OCI_REGION }}.ocir.io/${{ secrets.OCI_TENANCY_OCID }}/${{ secrets.OCI_REPOSITORY_NAME }}/spring-boot-app:$IMAGE_TAG .

      # 7. 推送镜像到OCI仓库
      - name: Push Docker image to OCI
        run: |
          IMAGE_TAG=${{ github.event.release.tag_name || github.sha }}
          docker push ${{ secrets.OCI_REGION }}.ocir.io/${{ secrets.OCI_TENANCY_OCID }}/${{ secrets.OCI_REPOSITORY_NAME }}/spring-boot-app:$IMAGE_TAG

配套Dockerfile示例 #

确保项目根目录存在Dockerfile，示例内容如下：

# 使用官方OpenJDK基础镜像
FROM eclipse-temurin:17-jdk-slim

# 设置工作目录
WORKDIR /app

# 复制打包好的Spring Boot JAR文件到镜像中
COPY target/*.jar app.jar

# 暴露应用端口（匹配你的Spring Boot配置的server.port）
EXPOSE 8080

# 启动应用
ENTRYPOINT ["java", "-jar", "/app/app.jar"]

关键说明 #

• 触发条件：默认在main分支推送或发布新版本时触发，可按需修改on字段
• 镜像标签：优先使用Release版本号，否则用Git提交SHA，保证镜像版本唯一
• OCI CLI配置：通过生成本地配置文件完成身份验证，Ubuntu runner默认预装OCI CLI
• 权限：确保OCI用户拥有OBJECTSTORAGE_NAMESPACE_MANAGE和REPOSITORY_PUSH权限

内容的提问来源于stack exchange，提问作者jmcunst