GitLab CI/CD 之 artifacts

-

前言

上次我們教到 Gitlab-Runner 註冊與 tags 使用，今天我們要教 Gitlab CI/CD 中的 artifacts，這可以幫助我們在 CI/CD 過程中，達到一個報告效果。我們這次在文章的最下方會提供我用 C# .Net Core Web Api 寫好的範本，供給大家使用，大家可以拿我的範例做練習。

artifacts 作用

artifacts 可以在我們 CI/CD 過程中可以拿到一份報告，比如說單元測試報告，或這是程式碼風格報告，我們可以拿這份報告查看測試結果，以便我們日後修改系統。

artifacts 定義規則

在工作區我們定義 artifacts，定義我們測試怎麼測試以及測試報告使用甚麼形式文件下載，有如以下範例。

image: mcr.microsoft.com/dotnet/sdk:6.0


stages:

    - testing


unit-tests:

    stage: testing

    tags:

        - docker

    script:

        - dotnet test DotNetCoreUtils.Tests > DotNetCoreUtils.Tests.txt

    artifacts:

        paths:

            - DotNetCoreUtils.Tests.txt

        expire_in: "30 days"

    only:

        - main

        - develop

補充 artifacts

paths: 在 artifacts 裡面有個 paths 是指文件要輸出的路徑。

expire_in: 在 artifacts 裡面有個 expire_in 是指文件保存有效期限多少天

練習時間

請各位 clone 我的 DotNetCoreWebApiCiAndCdCourse 教學專案，然後我們新增 .gitlab-ci.yml 檔案，製作我們下方 CI/CD 流程

image: mcr.microsoft.com/dotnet/sdk:6.0


stages:

    - testing


unit-tests:

    stage: testing

    tags:

        - docker

    script:

        - dotnet test DotNetCoreWebApiCiAndCdCourse.Tests > DotNetCoreWebApiCiAndCdCourse.Tests.txt

    artifacts:

        paths:

            - DotNetCoreWebApiCiAndCdCourse.Tests.txt

        expire_in: "30 days"

    only:

        - main

        - develop

接下來我們來看我們的測試結果，可以看到我們寫的測試通過。

下載測試報告

在我們 gitlab 中看到 Build->Artifacts 可以看到我們剛才測試後所產生的檔案，我們去下載測試報告檔案

下載完後會得到一份壓縮檔，解壓縮的目錄底下會有一份 txt 可以看到測試報告結果，這時候你就可以直接拿這份報告給老闆。

教學文件

留言

發佈留言

此網誌的熱門文章

Docker 之如何安裝 Docker 容器

-
圖片
前言 上次我們講到 Docker 的功用與好處，今天我們要在講解，如何安裝 Docker 這個容器，讓我們在之後的教學應用更好的實作與練習，現在讓我們開始吧 Docker Engine 與 Docker Desktop 首先在講解怎麼安裝 Docker 時，我們先講解 Docker Engine 跟 Docker Desktop 有甚麼不一樣，Docker Engine 是 Docker 最核心的部分，只要在電腦安裝了這個引擎，就可以馬上體驗 Docker，但是由於在操作 Docker 時，幾乎是命令介面，所以 Docker 後來有出 Docker Desktop，提供 UI 介面，盡可能貼近使用者操作，不過還是有很多事情是不能透過 Docker Desktop 去操作的 Docker 安裝環境選擇 如果你的電腦是一般練習的電腦，例如: 桌機、筆電，且作業系統是桌面型作業系統，那就可安裝 Docker Desktop，即可幫助你直接安裝好 Docker Engine，有完善的 UI 介面，如果你想自己灌一台伺服器等級的虛擬機，例如: 安裝 Ubuntu Server，那即可安裝好 Docker Engine 就可以體驗 Docker，不建議在虛擬機上安裝例如像 Ubuntu Desktop，裡面又安裝 Docker Desktop ，因為可能會有資源不夠的問題，現在如何安裝 Docker Engine 及 Docker Desktop 安裝 Docker Desktop 在這裡我們已 Windows 為範例，在我的文章最下面提供 Docker 官網下載網站，如果你的作業系統是 Windows 作業系統，就下載 Windows 版本 Docker Desktop，並依照安裝指示操作，即可完成安裝 以下是安裝玩後的 Docker Desktop 樣子，即可開始體驗 Docker 安裝 Docker Engine 如果你的作業系統是屬於伺服器等級的作業系統那只要安裝 Docker Engine 就好，在文章最下方會提供 Docker 官網安裝 Docker Engine 文獻，而下圖是以 Ubuntu 為例子的文獻，按照官網說明指令輸入，相信不會太困難 ...
閱讀更多

Gitlab CI/CD 什麼是 CI/CD

-
圖片
前言 什麼是 CI/CD ? CI/CD 可以幫助我們做到什麼事情? 為什麼要有 CI/CD ?         在傳統程式上線流程，例如可能要透過 FTP  上傳至伺服器，接著去修改環境變數，然後測試程式是否運作正常，然後伺服器重新開機就上線了。         在近代程式上線流程，例如說會有個像 Gitlab、GitHub 或者是 Jenkins，會有程式碼版控系統，把程式碼上傳上去至平台上，然後可能還跑一些測試，然後開啟 FTP，將程式碼上傳至伺服器，修改環境變數，然後就上線。         在現在程式上線流程，一樣會有個像 Gitlab、Jenkins 這樣的平台，然後我們將我們寫好的程式功能，上傳到平台上，接著我們會寫一些自動化測試的功能及自動化佈署的功能腳本，然後這些平台會去讀取我們撰寫好的腳本，去跑測試，以及佈署，可以幫助我們簡化許多佈署流程，整個佈署流程有如以下圖 什麼是 CI ? CI(Continuous Integration) 是指持續整合，也就是在工程師，在撰寫程式新功能，或者修正 Bug，上傳到 GitLab 平台，然後如果功能沒有問題打包 Docker Image，在這過程叫持續整合。 什麼是 CD ? CD(Continuous Delivery/Deployment) 是指時序交付或是持續佈署，在程式碼寫完沒問題，要佈署到伺服器，這個過程叫做時序佈署，那為什麼還會有持續交付，那是因為通常會準備是少兩個或三個環境，來進行模擬上線，測試系統功能是否正常，如果在 development 主機及 staging 主機有問題時，在重新修補功能，然後再次模擬上線及測試系統功能，在最後一切沒有問題時，佈署近正式主機，以達成上線功能。 以持續交付的話，有如上圖在不斷有新功能佈署到 development 和 staging 主機的這過程，可叫持續交付 以持續佈署的話，有如上圖不斷佈署至 development 、staging 和 production，這整個大框架叫持續佈署
閱讀更多

Docker 之建立與使用 Docker Image 清理本地 Image

-
圖片
前端 為了實驗我們上傳的 Docker Image 有沒有問題，我們先在學一個刪除本地 Docker Image，刪除 Docker Image 要使用 docker rmi <image> 這個語法，現在開始刪除本地 Docker Image 輸入以下指令 docker rmi timmmmmmm/nginx 啟用與下載 Docker Image 接下來我們再次抓回我們上傳的 Docker Image，輸入以下指令 docker pull timmmmmm/nginx 可以發現我們已經成功抓回 Docker Image 再來我們要使用這個 Docker Image 啟動容器，輸入以下指令 docker run -d -p 80:80 timmmmmmm/nginx 啟動成功之後，可以發現我們啟動容器成功 而且在瀏覽器可以看到我們 nginx 服務成功啟動
閱讀更多