Day 15: 封裝上傳自動化!Jenkins到Nexus的輸送鏈!

14th鐵人賽 devops cicd

Jam K.

2022-09-27 10:04:59

2112 瀏覽

分享至

昨天我們成功安裝好Nexus，亦成功把封裝好的NodeJS程序上傳到Nexus中。今天就讓我們一起把整個流程自動化運作起來吧!

加入Credential

為了讓Jenkins連接Nexus，我們需要為Nexus加入一個Credential作為認證。首先到Jenkins的設定頁面，然後按下Manage Credentials。

然後在Stores scoped to Jenkins下面的列表中，按下Jenkins那一行Domains列的(global)連結。

然後在左邊的選單中按下Add Credentials。

然後輸入Nexus的登入帳號及密碼，然後在ID一欄填入nexus-user方便辨認。然後按Create。

完成後會看見列表中增加了一個新的Credential。

更新Jenkinsfile

設定好Nexus的連接後，我們可以開始利用Jenkins去自動化封裝及上傳流程了。

首先，我們先為這個封裝上傳加入一個新的Stage。在上一個章節的Dependency Track的Stage的Block下方加入以下內容。

       stage('Nexus Publisher') {
            steps {

            }
        }

正常情況下，當我們要推送套件到Nexus中，我們要先運行npm adduser去登入服務。但當我們進行自動化流程時，這個步驟就會阻礙我們進行自動化。因此我們需要以另外一種方式為NPM加入認證設定。

為了幫NPM加入認證。在steps{…}的Block中引用上一部份加入的Credential，變為以下的內容。

       stage('Nexus Publisher') {
            steps {
                    withCredentials([usernamePassword(credentialsId: 'nexus-user', usernameVariable: 'NEXUS_USER', passwordVariable: 'NEXUS_PSWD')]) {
                }
            }
        }

credentialsID: 使用我們新增的Credential nexus-user
usernameVariable: 利用NEXUS_USER作為變數儲存Nexus的用戶名稱
passwordVariable: 利用NEXUS_PSWD作為變數儲存Nexus的用戶密碼

然後，我們使用認證的資料儲存為.npmrc去讓NPM存取Nexus。為withCredentails(…){…}加入以下內容。

                        script{
                            def nexusAuth = sh(returnStdout: true, script: "echo -n '${NEXUS_USER}:${NEXUS_PSWD}' | openssl base64").trim()
                            echo "nexusAuth =  ${nexusAuth}"
                            sh "echo 'always-auth=true\n_auth=${nexusAuth}\n' > .npmrc"
                        }

這裡我們使用了openssl base64把登入資料轉化為一條認證Token。然後把認證資料輸出到.npmrc的檔案中。

最後，在這裡下方加入以下內容，去把NodeJS的套件推送到我們的Nexus中。

                            echo "Publish Artifact"
                            sh "npm publish --registry=http://host.docker.internal:8083/repository/ironman-npm-repo"

要留意的是，由於我們的Jenkins是使用Docker，當要從Container內部連接本地服務(localhost)時，要使用host.docker.internal作為Domain。然後repository/ironman-npm-repo代表我們昨天設定的NPM Repository。

最後，完整的Block應該會如下。

        stage('Nexus Publisher') {
            steps {
                nodejs(nodeJSInstallationName: 'NodeJS'){
                    withCredentials([usernamePassword(credentialsId: 'nexus-user', usernameVariable: 'NEXUS_USER', passwordVariable: 'NEXUS_PSWD')]) {
                        script{
                            def nexusAuth = sh(returnStdout: true, script: "echo -n '${NEXUS_USER}:${NEXUS_PSWD}' | openssl base64").trim()
                            echo "nexusAuth =  ${nexusAuth}"
                            sh "echo 'always-auth=true\n_auth=${nexusAuth}\n' > .npmrc"
                            echo "Publish Artifact"
                            sh "npm publish --registry=http://host.docker.internal:8083/repository/ironman-npm-repo"
                        }
                    }
                }
            }
        }

修改完成後，我們進行Commit、Push，然後在Jenkins中按下Build Now。