【 Cloud 】將 React 透過 Azure Container Registry 部署到 Azure Kubernetes Service ( AKS )

內容

學習目標
前置準備作業
專案目錄結構
建立 React 專案的 Docker Image 並部署到 Azure Container Registry
建立 Azure Kubernetes Service
部署 React 到 AKS
測試與驗證
刪除所建立的資源與服務

學習目標

如何將 React 透過 Azure Container Registry 部署到 Azure Kubernetes Service ( AKS )

前置準備作業

已建立 Azure 帳號並能正常登入
已於電腦端存在可正常執行的 React 專案
已於電腦端安裝 IDE，本範例使用 Visual Studio Code
已於電腦端安裝 Docker Engine
- https://docs.docker.com/engine/install/
已於電腦端安裝 AZ Cli
- https://docs.microsoft.com/zh-tw/cli/azure/install-azure-cli
已於電腦端安裝 kubectl
- https://kubernetes.io/docs/tasks/tools/

專案目錄結構

└── aks-deploy-react
    ├── docker-manifests
    │   └── Dockerfile
    ├── kube-manifests
    │   ├── 01-Deployment.yml
    │   └── 02-LoadBalancer.yml
    └── react-web
        ├── README.md
        ├── package-lock.json
        ├── package.json
        ├── public
        │   ├── favicon.ico
        │   ├── index.html
        │   ├── logo192.png
        │   ├── logo512.png
        │   ├── manifest.json
        │   └── robots.txt
        └── src
            ├── App.css
            ├── App.js
            ├── App.test.js
            ├── index.css
            ├── index.js
            ├── logo.svg
            ├── reportWebVitals.js
            └── setupTests.js

建立 Azure Container Registry

Step 1. 登入到 Azure

請在終端機輸入下方內容
```
az login
```

Step 2. 建立 Azure 資源群組

請在終端機輸入下方內容
```
az group create --name ResourceGroupName --location Region
```
- 修改指令中的 ResourceGroupName 為唯一可識別的名稱。
- 修改指令中的 Region 請輸入資源部署於何處
  - 可輸入 az account list-locations -o table 查看可用區域
- 本範例使用如下
```
az group create --name aks-test-rg --location westus2
```

Step 3. 建立 Azure Container Registry ( ACR )

請在終端機輸入下方內容
```
az acr create -n AcrName -g ResourceGroupName --sku SkuLevel --admin-enabled true
```
- 請修改指令中的 AcrName 為唯一且可識別的名稱。
- 請修改指令中的 ResourceGroupName 為 Step 2 的名稱。
- 請修改指令中的 SkuLevel 為可選 Basic、Standard、Premium。
- 本範例使用如下
```
az acr create -n containerforaks -g aks-test-rg --sku Basic --admin-enabled true
```

建立 React 專案的 Docker Image 並部署到 Azure Container Registry

Step 1. 取得 Azure Container Registry 的 Login Server URL

請在終端機輸入下方內容
```
az acr list -o table -g ResourceGroupName
```
- 請修改指令中的 ResourceGroupName 為 建立 Azure Container Registry 段落中 Step 2 的名稱。
- 本範例使用如下
```
az acr list -o table -g aks-test-rg
```

Step 2. 建立 Dockerfile

建立 docker-manifests 資料夾並在此資料夾中建立 Dockerfile 的檔案，再輸入以下內容

Step 3. 建立 Docker Image

請在終端機切換路徑到專案目錄再輸入下方內容
```
docker build -t AcrUrl/ImageName:Tag -f docker-manifests/Dockerfile .
```
- 請修改指令中的 AcrUrl 為 Step 1 所取得的 URL。
- 請修改指令中的 ImageName 為可識別的名稱。
- 請修改指令中的 Tag 為版號。
- 本範例使用如下
```
docker build -t containerforaks.azurecr.io/docker-react:0.1 -f docker-manifests/Dockerfile .
```

Step 4. 查看本地端 Image

請在終端機輸入下方內容
```
docker images
```

Step 5. 登入到 Azure Container Registry

請在終端機輸入下方內容
```
az acr login --name AcrName
```
- 請修改指令中的 AcrName 為 建立 Azure Container Registry 段落中 Step 2 的名稱。
- 本範例使用如下
```
az acr login --name containerforaks
```

Step 6. 上傳 Image 到 Azure Container Registry

請在終端機輸入下方內容
```
docker push AcrUrl/ImageName:Tag
```
- 請修改指令中的 AcrUrl 為 Step 1 所取得的 URL。
- 請修改指令中的 ImageName 為 Step 2 的名稱。
- 請修改指令中的 Tag 為 Step 2 的版號。
- 本範例使用如下
```
docker push containerforaks.azurecr.io/docker-react:0.1
```

Step 7. 查看 Azure container registry

透過瀏覽器開啟 https://portal.azure.com/ 並登入成功之後於上方搜尋框輸入 container registry 再點選 Container registries 的結果

選擇所建立的 registry

點選左側的 Repositories

點選所上傳的 Image

建立 Azure Kubernetes Service

Step 1. 建立 AKS

請在終端機輸入下方內容
```
az aks create -g ResourceGroupName -n AksName
```
- 修改指令中的 ResourceGroupName 請輸入 建立 Azure Container Registry 段落中 Step 2 的名稱。
- 修改指令中的 AksName 成唯一可識別的名稱。
- 本範例使用如下
```
az aks create -g aks-test-rg -n aks-react-test
```

部署 React 到 AKS

Step 1. 取得 Azure Kubernetes Service Credential

請在終端機輸入下方內容
```
az aks get-credentials --resource-group ResourceGroupName --name AksName
```
- 修改指令中的 ResourceGroupName 請輸入 建立 Azure Container Registry 段落中 Step 2 的名稱。
- 修改指令中的 AksName 請輸入段落 建立與設定 Azure Kubernetes Service 中 Step 1 所建立的名稱。
- 本範例使用如下
```
az aks get-credentials --resource-group aks-test-rg --name aks-react-test
```

Step 2. 設定 Azure Kubernetes Service 與 Azure Container Registry 連結

請在終端機輸入下方內容
```
az aks update -n AksName -g ResourceGroupName --attach-acr AcrName
```
- 修改指令中的 AksName 請輸入段落 建立與設定 Azure Kubernetes Service 中 Step 1 所建立的名稱。
- 修改指令中的 ResourceGroupName 請輸入 建立 Azure Container Registry 段落中 Step 2 的名稱。
- 修改指令中的 AcrName 請輸入段落 建立 Azure Container Registry 中 Step 2 所建立的名稱。
- 本範例使用如下
```
az aks update -n aks-react-test -g aks-test-rg --attach-acr containerforaks
```

Step 3. 建立 Deployment 的 YAML

請在專案目錄中建立 kube-manifests 資料夾並在此資料夾中建立 01-Deployment.yml 檔案，其內容如下
- 請修改 第 18 行 中的 AcrUrl 為 建立 React 專案的 Docker Image 並部署到 Azure Container Registry 段落中 Step 1 的 URL。
- 請修改 第 18 行 中的 ImageName 為 建立 React 專案的 Docker Image 並部署到 Azure Container Registry 段落中 Step 3 的名稱。
- 請修改 第 18 行 中的 Tag 為 建立 React 專案的 Docker Image 並部署到 Azure Container Registry 段落中 Step 3 的版號。
- 本範例使用如下

Step 4. 建立 LoadBalancer 的 YAML

請在專案目錄中的 kube-manifests 資料夾並在此資料夾中建立 02-LoadBalancer.yml 檔案，其內容如下

Step 5. 部署 Application

請在終端機輸入下方內容
```
kubectl apply -f kube-manifests/
```

測試與驗證

Step 1. 查看 Pods

請在終端機輸入下方內容
```
kubectl get pods
```

Step 2. 查看 Deployment

請在終端機輸入下方內容
```
kubectl get deployment
```

Step 3. 查看 Service 並取得 IP

請在終端機輸入下方內容以取得 EXTERNAL-IP
```
kubectl get service
```

Step 4. 存取 React

請在瀏覽器輸入下方內容
```
http://EXTERNAL-IP
```
- 請把 EXTERNAL-IP 改成 Step 3 所取得的 EXTERNAL-IP

刪除所建立的資源與服務

Step 1. 刪除 Application

請在終端機輸入下方內容
```
kubectl delete -f kube-manifests/
```

Step 2. 查看 Pods

請在終端機輸入下方內容
```
kubectl get pods
```

Step 3. 查看 Deployment

請在終端機輸入下方內容
```
kubectl get deployment
```

Step 4. 查看 Service

請在終端機輸入下方內容
```
kubectl get service
```

Step 5. 刪除所建立的相關資源

請在終端機輸入下方指令
```
az group delete -n ResourceGroupName
```
- 修改指令中的 ResourceGroupName 請輸入 建立 Azure Container Registry 段落中 Step 2 的名稱。
- 本範例使用如下
```
az group delete -n aks-test-rg
```

GitHub

ArcherHuang @ GitHub

內容