<!-- Maven settings.xml -->
<mirrors>
    <mirror>
        <id>nexus</id>
        <url>http://nexus.internal/repository/maven-public/</url>
        <mirrorOf>*</mirrorOf>
    </mirror>
</mirrors>

# Maven：指定本地倉庫位置
mvn install -Dmaven.repo.local=/cache/.m2

# Gradle：啟用建置快取
gradle build --build-cache

# npm：使用快取
npm ci --cache /cache/.npm

# Maven：只建置有變化的模組
mvn install -pl :changed-module -am

# Gradle：預設支援增量建置
gradle build  # 自動跳過未變化的任務

# Maven：並行建置
mvn install -T 4  # 使用 4 個執行緒
mvn install -T 1C  # 每個 CPU 核心一個執行緒

# Gradle：並行建置
gradle build --parallel

# 利用分層快取的 Dockerfile
FROM openjdk:11-jre-slim

# 先複製依賴（不常變化）
COPY pom.xml /app/
RUN mvn dependency:go-offline

# 再複製原始碼（經常變化）
COPY src /app/src
RUN mvn package -DskipTests

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-enforcer-plugin</artifactId>
    <version>3.0.0</version>
    <executions>
        <execution>
            <id>enforce</id>
            <goals>
                <goal>enforce</goal>
            </goals>
            <configuration>
                <rules>
                    <!-- 依賴收斂：確保沒有依賴衝突 -->
                    <dependencyConvergence/>

                    <!-- 禁止特定依賴 -->
                    <bannedDependencies>
                        <excludes>
                            <exclude>commons-logging:*</exclude>
                            <exclude>log4j:log4j</exclude>
                        </excludes>
                    </bannedDependencies>

                    <!-- 要求最低 Java 版本 -->
                    <requireJavaVersion>
                        <version>[11,)</version>
                    </requireJavaVersion>

                    <!-- 要求最低 Maven 版本 -->
                    <requireMavenVersion>
                        <version>[3.6,)</version>
                    </requireMavenVersion>

                    <!-- 禁止 SNAPSHOT 依賴（發布時）-->
                    <requireReleaseDeps>
                        <onlyWhenRelease>true</onlyWhenRelease>
                    </requireReleaseDeps>
                </rules>
            </configuration>
        </execution>
    </executions>
</plugin>

stages:
  - build # 編譯打包
  - test # 測試
  - analyze # 靜態分析
  - package # 製品打包
  - deploy # 部署

pipeline {
    agent any

    environment {
        MAVEN_OPTS = '-Dmaven.repo.local=/cache/.m2'
    }

    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }

        stage('Build') {
            steps {
                sh 'mvn clean compile -T 1C'
            }
        }

        stage('Test') {
            parallel {
                stage('Unit Tests') {
                    steps {
                        sh 'mvn test'
                    }
                }
                stage('Static Analysis') {
                    steps {
                        sh 'mvn sonar:sonar'
                    }
                }
            }
        }

        stage('Package') {
            steps {
                sh 'mvn package -DskipTests'
            }
        }

        stage('Deploy to Staging') {
            when {
                branch 'main'
            }
            steps {
                sh './deploy.sh staging'
            }
        }
    }

    post {
        always {
            junit '**/target/surefire-reports/*.xml'
            archiveArtifacts artifacts: 'target/*.jar'
        }
        failure {
            slackSend channel: '#ci-alerts',
                      message: "Build Failed: ${env.JOB_NAME}"
        }
    }
}

# Jenkins Kubernetes Plugin 組態
apiVersion: v1
kind: Pod
metadata:
  labels:
    jenkins: slave
spec:
  containers:
    - name: jnlp
      image: jenkins/jnlp-slave:latest
      resources:
        requests:
          cpu: "1"
          memory: "2Gi"
        limits:
          cpu: "2"
          memory: "4Gi"
    - name: maven
      image: maven:3.8-openjdk-11
      command: ["cat"]
      tty: true

# 建置階段
FROM maven:3.8-openjdk-11 AS builder
WORKDIR /build
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn package -DskipTests

# 執行階段
FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=builder /build/target/*.jar app.jar
USER 1000
EXPOSE 8080
CMD ["java", "-jar", "app.jar"]

# 使用有意義的標籤
myapp:1.2.3                    # 語義版本
myapp:1.2.3-abc1234            # 版本 + Git Commit
myapp:20231215-abc1234         # 日期 + Git Commit

# 避免
myapp:latest                   # 難以追蹤版本