前言

???云端部署新體驗(yàn)，C# Web API 遇上 Git Docker，828 B2B 企業(yè)節(jié)特惠來襲！Flexus X 實(shí)例，為您的 C#應(yīng)用提供強(qiáng)大支撐，結(jié)合 Git 版本控制與 Docker 容器化部署，實(shí)現(xiàn)代碼高效管理與無縫遷移。即刻行動(dòng)，讓您的 Web 服務(wù)更加穩(wěn)定、高效，領(lǐng)跑數(shù)字化轉(zhuǎn)型之路！

???本實(shí)驗(yàn)深入演示了如何在 Ubuntu 環(huán)境中，利用 Git 進(jìn)行版本控制管理代碼，并通過 Docker 技術(shù)自定義構(gòu)建鏡像，從而實(shí)現(xiàn)項(xiàng)目從代碼到應(yīng)用的快速構(gòu)建、打包與部署流程。這一流程不僅提升了開發(fā)效率，還確保了環(huán)境的一致性與可重復(fù)性。

環(huán)境準(zhǔn)備

購(gòu)買服務(wù)器配置

本次實(shí)驗(yàn)使用的是 Flexus 云服務(wù)器 X 實(shí)例 服務(wù)器。

在性能設(shè)置中我選擇了自定義模式，使用了 4vCPUs | 12GiB，鏡像我選用的是最高版本的 ubuntu

打開 xshell，使用購(gòu)買的服務(wù)器的公網(wǎng) IP 地址，和設(shè)置的密碼，連接上我們的服務(wù)器。

項(xiàng)目部署

項(xiàng)目準(zhǔn)備（Dockerfile 文件）

我這里以 c#為例，新建一個(gè) .net8.0 的 Web API 項(xiàng)目

這個(gè)新建的官網(wǎng)的 webApi 項(xiàng)目自帶一個(gè)接口 weatherforecast 接口，可以獲取到最近的天氣，因?yàn)楸酒饕康氖侨绾问褂?git+docker 在服務(wù)器上發(fā)布，因此不做太多改動(dòng)。本地啟動(dòng)一下，成功訪問到，我們稍后將這個(gè)程序部署到服務(wù)器上。

因?yàn)槲覀兒竺娌捎?Git 方式來發(fā)布應(yīng)用，因此在 gitee 上新建倉(cāng)庫，將代碼上傳上去。

在項(xiàng)目路徑下新建一個(gè) Dockerfile 文件，內(nèi)容如下（根據(jù)自己的解決方案名稱、構(gòu)建環(huán)境，如.net 6.0、7.0 等版本，亦或是其他語言，對(duì)以下代碼就行調(diào)整，本部署方式適用于其他編程語言或其他版本的.net）

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS baseUSER $APP_UIDWORKDIR /appEXPOSE 8080FROM mcr.microsoft.com/dotnet/sdk:8.0 AS buildARG BUILD_CONFIGURATION=ReleaseWORKDIR /srcCOPY ["WebApplication1/WebApplication1.csproj", "WebApplication1/"]RUN dotnet restore "WebApplication1/WebApplication1.csproj"COPY . .WORKDIR "/src/WebApplication1"RUN dotnet build "WebApplication1.csproj" -c $BUILD_CONFIGURATION -o /app/buildFROM build AS publishARG BUILD_CONFIGURATION=ReleaseRUN dotnet publish "WebApplication1.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=falseFROM base AS finalWORKDIR /appCOPY --from=publish /app/publish .ENTRYPOINT ["dotnet", "WebApplication1.dll"]

這段 Dockerfile 用于構(gòu)建一個(gè) ASP.NET Core 應(yīng)用程序的 Docker 鏡像

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base：從 Microsoft Container Registry (MCR) 拉取 ASP.NET Core 8.0 的官方運(yùn)行時(shí)鏡像作為基礎(chǔ)鏡像，并將其標(biāo)記為 base。這個(gè)鏡像包含了運(yùn)行 ASP.NET Core 應(yīng)用程序所需的一切，但不包含構(gòu)建工具。

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build：從 Microsoft Container Registry 拉取 ASP.NET Core 8.0 的官方 SDK 鏡像，用于構(gòu)建應(yīng)用程序。這個(gè)鏡像包含了構(gòu)建.NET 應(yīng)用程序所需的一切工具。

通過這種方式，Dockerfile 利用了 Docker 的多階段構(gòu)建特性，確保了構(gòu)建過程中只包含必要的工具（在構(gòu)建階段使用 SDK，在最終鏡像中僅包含運(yùn)行時(shí)），從而減小了最終鏡像的大小。

Git 部署并拉取代碼

安裝 Git

打開終端，然后輸入以下命令來安裝 Git

sudo apt update sudo apt install git

配置 Git 用戶信息

在安裝 Git 后，建議配置你的用戶名和電子郵件地址。這些信息將用于你的 Git 提交，并幫助你識(shí)別代碼更改的源頭。

git config --global user.name "你的名字" git config --global user.email "你的郵箱地址"

SSH 密鑰

雖然你可以通過 HTTPS URL 克隆倉(cāng)庫，但使用 SSH 密鑰可以更安全地訪問你的倉(cāng)庫。

檢查是否已存在 SSH 密鑰：

ls -al ~/.ssh

如果控制臺(tái)輸入結(jié)果像我一樣

.ssh文件夾是存在的，沒有看到 id_rsa和 id_rsa.pub文件，說明沒有包含任何 SSH 密鑰。那么你需要生成一個(gè)新的 SSH 密鑰對(duì)。

chmod 700 /root/.ssh//更改 /root/.ssh 目錄的權(quán)限,700 意味著只有目錄的所有者 ssh-keygen -t rsa -b 4096 -C "你的郵箱地址"

命令執(zhí)行后，它會(huì)詢問你“Enter file in which to save the key (/root/.ssh/id_rsa):”，這是在詢問你希望將生成的私鑰保存在哪個(gè)文件中。默認(rèn)情況下，它會(huì)建議你保存在/root/.ssh/id_rsa

直接按回車鍵，它會(huì)接受默認(rèn)的文件名/root/.ssh/id_rsa來保存私鑰

接下來，會(huì)要求你輸入一個(gè)密碼（passphrase）來保護(hù)私鑰。這是一個(gè)可選步驟，如果你不想設(shè)置密碼，只需再次按回車鍵即可跳過此步驟

再次輸入 ls -al ~/.ssh，可以看到.ssh 目錄下已經(jīng)生成 id_rsa.pub 等文件了。

輸入以下命令，公鑰內(nèi)容將被輸出到終端，然后我們復(fù)制這些內(nèi)容。

cat /root/.ssh/id_rsa.pub

這里以 gitee 為例，我們將公鑰添加到安全設(shè)置的 SSH 公鑰中。

添加完成后我們就可以在控制臺(tái)執(zhí)行命令將我們的項(xiàng)目代碼克隆下來了。

安裝 docker

Docker 在 Ubuntu 上依賴一些軟件包，需要先行安裝。

sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release

添加 Docker GPG 密鑰

這是為了驗(yàn)證從 Docker 倉(cāng)庫下載的軟件包的完整性。

#官方 GPG key （可能國(guó)內(nèi)訪問會(huì)存在問題）curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg# 阿里源（推薦使用）curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

添加 Docker 官方軟件源

接下來，需要將 Docker 的官方軟件源添加到你的 Ubuntu 系統(tǒng)中。運(yùn)行以下命令（根據(jù)你的 Ubuntu 版本，$(lsb_release -cs)會(huì)自動(dòng)替換為你的 Ubuntu 代號(hào)，如 focal、jammy 等）：

#Docker 官方源 echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null#阿里 apt 源 echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

再次更新軟件包列表

添加完軟件源后，再次運(yùn)行更新命令以確保你的軟件包列表是最新的：

sudo apt updatesudo apt-get update

安裝 docker

#安裝最新版本的 Dockersudo apt install docker-ce docker-ce-cli containerd.io#查看 Docker 版本 docker version#查看所有容器 docker ps -a

項(xiàng)目運(yùn)行

構(gòu)建鏡像

cd 到我們使用 git 拉下來的項(xiàng)目，如下，包含 Dockerfile 的目錄下

執(zhí)行命令構(gòu)建一個(gè)新的 Docker 鏡像

docker build -t auth .

構(gòu)建成功后執(zhí)行 docker images 查看鏡像，如下我名稱為 auth 的鏡像已經(jīng)構(gòu)建完成。

運(yùn)行容器

docker run -d -p 8080:8080 --restart=always --name auth auth

-d: 這個(gè)標(biāo)志表示以“分離模式”運(yùn)行容器，也就是說，容器會(huì)在后臺(tái)運(yùn)行。你不會(huì)直接看到容器的輸出，除非你使用 docker logs命令或其他方法來查看。

-p 8080:8080: 這個(gè)參數(shù)用于端口映射。它將容器內(nèi)的 8080 端口映射到宿主機(jī)的 8080 端口上。這樣，任何發(fā)送到宿主機(jī) 8080 端口的請(qǐng)求都會(huì)被轉(zhuǎn)發(fā)到容器的 8080 端口上。

--restart=always: 這個(gè)參數(shù)指定了容器的重啟策略。always表示無論何時(shí)容器停止運(yùn)行（無論是因?yàn)橥顺鲞€是 Docker 守護(hù)進(jìn)程重啟），Docker 都會(huì)自動(dòng)重啟這個(gè)容器。

運(yùn)行完成后可以執(zhí)行 docker ps 查看容器：

新增安全組

打開服務(wù)器控制臺(tái)，找到我們當(dāng)前的服務(wù)器，點(diǎn)擊名稱。

進(jìn)去到詳情后，切換到安全組頁面，點(diǎn)擊配置規(guī)則。

在入方向規(guī)則下，點(diǎn)擊添加規(guī)則，然后加入我們項(xiàng)目的端口號(hào)。

訪問接口

查看我們的服務(wù)器的 ip 地址

打開瀏覽器，訪問我們項(xiàng)目的接口，成功獲取到信息。

更新發(fā)布

接下來我們將接口調(diào)整一下，改為返回一個(gè) hello word！

提交代碼

回到服務(wù)器控制臺(tái)，執(zhí)行 git pull 拉取最新代碼

使用更新后的代碼重新構(gòu)建 Docker 鏡像。運(yùn)行與之前相同的 docker build 命令

docker build -t auth .

停止并刪除舊的容器。

docker stop auth docker rm auth

使用更新后的鏡像啟動(dòng)一個(gè)新容器。

docker run -d -p 8080:8080 --restart=always --name auth auth

刷新一下我們的瀏覽器，頁面中返回的信息是 hello word!

審核編輯 黃宇