配置 CLI

在此步驟中，您將配置 oc 以指向新建立的叢集。 Red Hat OpenShift on IBM Cloud Container Platform CLI 提供管理應用程式的指令，以及與系統各元件互動的低階工具。 該 CLI 可透過 oc 指令使用。

1. 當叢集備妥時，按一下 OpenShift Web 主控台 以開啟主控台。
2. 在 Web 主控台上，從頁面右上方的下拉功能表中，按一下 複製登入指令，然後按一下 顯示記號 鏈結。
3. 複製 在 使用此記號登入下找到的文字。
4. 使用 oc login 指令登入後，執行下列指令即可查看群集中的所有命名空間。

   oc get ns
   

建立專案

Kubernetes 名稱空間提供了限定叢集裡資源範圍的機制。 在 Red Hat OpenShift on IBM Cloud 中，專案是具有額外註釋的 Kubernetes 名稱空間。

1. 定義名為 MYPROJECT 的環境變數，並將 <your-initials> 取代為您自己的首字母，以設定應用程式名稱:

   export MYPROJECT=<your-initials>-openshiftapp
   

2. 建立新專案。

   oc new-project $MYPROJECT
   

   使用上述指令建立專案之後，您會自動切換至該專案，以及隨後在該專案環境定義中執行的所有指令。 如果您需要在稍後階段切換專案或回到該專案，請使用 oc project $MYPROJECT 指令。

部署應用程式

使用 oc new-app 指令，您可以從本端或遠端 Git 儲存庫中的原始碼建立應用程式。

1. 使用 docker 建置策略來建立應用程式，以從儲存庫中的 Dockerfile 建置容器映像檔。 為了簡單起見，您將應用程式名稱設為專案名稱。

   oc new-app https://github.com/IBM-Cloud/openshift-node-app --name=$MYPROJECT --strategy=docker --as-deployment-config
   

   建立新的應用程式時，如果 Jenkins 檔案存在於來源儲存庫的根目錄或指定的環境定義目錄中，則 Red Hat OpenShift on IBM Cloud 會產生 pipeline 建置策略。 否則，它會產生 source 建置策略。 您一律可以設定 --strategy 旗標來置換建置策略。

2. 若要檢查建置器儲存器映像檔建立並推送至內部 Red Hat OpenShift on IBM Cloud Container Registry (OCR)，請執行下列指令。

   oc logs -f buildconfig/$MYPROJECT
   

   您的群集已設定為內含 Red Hat OpenShift on IBM Cloud Container Registry，因此 Red Hat OpenShift on IBM Cloud 可以在群集內自動建立、部署和管理應用程式生命週期。

3. 請等待建置成功，並推送映像檔。 您可以執行下列指令來檢查部署及服務的狀態。

   oc status
   

透過 IBM 提供的網域存取應用程式

若要存取應用程式，您需要建立路由。 路徑用於向外界公佈您的服務。

1. 在終端機執行以下指令，建立路由。

   oc expose service/$MYPROJECT
   

2. 您可以透過 IBM 提供的網域存取應用程式。 執行以下指令以取得 URL。

   oc get route/$MYPROJECT
   

3. 複製 HOST/PORT 值下的主機名稱的值，並將 URL 貼到瀏覽器中，即可在 http://<hostname> 上看到您的應用程式正在運作。 請務必在 URL 中使用 http。

4. 設定指向主機名稱的環境變數。

   export HOST=<hostname>
   

保護 IBM 提供的預設網域路徑

1. 若要建立使用 Red Hat OpenShift on IBM Cloud 的預設憑證加密的安全 HTTPS 路徑，可以使用 create route 指令。

   oc create route edge $MYPROJECT-https --service=$MYPROJECT --port=3000
   

2. 要取得 HTTPS 主機 URL，請執行 oc get routes。 將 URL 與 HTTPS (https://<HOST>) 複製並貼在瀏覽器中的路由 $MYPROJECT-https 旁邊。 這時您可以在 URL 中使用 https。

手動調整大小

1. 您可以使用 oc scale 指令來實現手動調整 Pod。 指令為部署組態或複製控制器設定新的大小

   oc scale dc/$MYPROJECT --replicas=2
   

2. 您可以透過執行 oc get pods 指令看到新的 Pod 正在佈建中。
3. 重新執行 監視 步驟，以查看更新的度量值。

自動調整

您可以使用水平 Pod Autoscaler (HPA) 來指定 Red Hat OpenShift on IBM Cloud 應該如何根據從屬於該 dc 或 rc 的 Pod 收集的度量值，自動增加或減少部署配置 (dc) 或抄寫控制器 (rc) 的規模。

1. 您必須先在叢集裡執行的 Pod 上設定資源限制，然後才能設定 Pod 的自動調整。 限制可讓您選擇 Pod 的 CPU 及記憶體用量下限及上限。 您可以使用 oc set resources 指令來設定容器上的限制及要求。

   oc set resources dc/$MYPROJECT --limits=cpu=250m,memory=512Mi --requests=cpu=100m,memory=256Mi
   

   如果要驗證，請執行 oc describe dc/$MYPROJECT，並尋找 Limits 和 Requests。
2. 若要建立 autoscaler，您需要執行 oc autoscale 指令，並針對所有 Pod 可由 autoscaler 設定的 Pod 數目及目標平均 CPU 使用率 (以所要求 CPU 的百分比表示) 設定下限 (下限) 及上限 (上限)。 對於測試，讓我們將 --cpu-percent 設為 5%。

   oc autoscale dc/$MYPROJECT \
    --min=1 \
    --max=5 \
    --cpu-percent=5
   

3. 重新執行 監視 步驟，以在應用程式上產生負載。
4. 您可以透過執行 oc get pods --watch 指令或在 Web 主控台中查看應用程式，來查看正在佈建的新 Pod。
5. 移除自動調整程式:

   oc delete hpa/$MYPROJECT
   

複製範例應用程式

在此區段中，您將複製 GitHub 儲存庫，該儲存庫隨附範本檔及 Shell Script，以從先前建立的環境變數產生 yaml 檔。 產生的檔案用來建置容器映像檔、將映像檔推送至專用容器登錄，以及部署新的應用程式。

1. 在終端機中，執行下列指令，將 GitHub 儲存庫複製到您的機器:

   git clone https://github.com/IBM-Cloud/openshift-node-app
   

2. 變更至應用程式目錄：

   cd openshift-node-app
   

更新 BuildConfig 並將建置器映像檔推送到 Container Registry

在此步驟中，您執行 Script 以更新 openshift.template.yaml 檔案的區段，並產生指向 Container Registry 名稱空間的新 yaml 檔案。

1. 執行下列 Bash Script，以更新 openshift.template.yaml 檔案中的位置保留元，並產生 openshift_private_registry.yaml 檔案。

   ./generate_yaml.sh use_private_registry
   

2. 從輸出執行匯出指令，以使用新的應用程式名稱來設定現有的 MYPROJECT 環境變數。 執行 echo $MYPROJECT 以查看新的應用程式名稱。

3. 選擇性地檢查產生的 openshift_private_registry.yaml 檔案，以查看是否已使用個別環境變數更新所有位置保留元。 下面是 3 個快速檢查的位置。 您可以跳至下一節。

4. 選用 尋找 name 屬性設為專案 ($MYPROJECT) 的 ImageStream 物件，並檢查 spec 的 dockerImageRepository 定義下是否已更新位置保留元 $MYREGISTRY、$MYNAMESPACE 及 $MYPROJECT

   -
   apiVersion: image.openshift.io/v1
   kind: ImageStream
   metadata:
     annotations:
       openshift.io/generated-by: OpenShiftNewApp
     creationTimestamp: null
     labels:
       app: $MYPROJECT
       app.kubernetes.io/component: $MYPROJECT
       app.kubernetes.io/instance: $MYPROJECT
     name: $MYPROJECT
   spec:
     dockerImageRepository: $MYREGISTRY/$MYNAMESPACE/$MYPROJECT
     lookupPolicy:
       local: false
   status:
       dockerImageRepository: ""
   

   映像檔串流及其關聯標籤提供了抽象概念，用於參照 Red Hat OpenShift on IBM Cloud Container Platform 中的容器映像檔

5. 選用 檢查 BuildConfig 下的 spec 區段，以取得已更新 name 下的輸出集至類型 DockerImage 及位置保留元。

   spec:
     nodeSelector: null
     output:
       to:
         kind: DockerImage
         name: $MYREGISTRY/$MYNAMESPACE/$MYPROJECT:latest
       pushSecret:
         name: push-secret
   

   建置是將輸入參數轉換為結果物件的程序。 通常，該程序用於將輸入參數或原始碼轉換為可執行的映像檔。 BuildConfig 物件是整個建置程序的定義。

6. 選用 搜尋 containers，請檢查 image 及 name

   containers:
   - image: $MYREGISTRY/$MYNAMESPACE/$MYPROJECT:latest
     name: $MYPROJECT
   

7. 如果已更新，請 儲存 YAML 檔案。

使用 IBM Cloud Container Registry 來部署應用程式

在本節中，您將使用產生的 openshift_private_registry.yaml 檔案將應用程式部署到群集。 部署後，您將藉由建立路徑來存取應用程式。

1. 使用更新的 yaml 建立新的 OpenShift 應用程式以及 buildconfig(bc)、deploymentconfig(dc)、service(svc)、imagestream(is)。

   oc apply -f openshift_private_registry.yaml
   

2. 若要檢查建立容器映像並將其推送到 Container Registry，請執行以下指令。

   oc logs -f bc/$PRIVREG
   

   在日誌中，如果將容器映像檔推送至專用容器登錄，則您應該會看到下列訊息。

   Pushing image us.icr.io/mods15/vmac-openshift-app-registry:latest ...
   Getting image source signatures
   Copying blob sha256:9d038e1c7afbe92c29313557c02110e8fb796818ebb78441c68929381103a94b
   Copying blob sha256:61c671f49591a059c9b6728a9f84c16f5b00126470112ee9c9f9e01dbbfcc3ea
   Copying blob sha256:e2787650308235c87eff7d2b88c3ab217e84b74a3fa9696103bd46bb99068c7a
   Copying blob sha256:dcef409117430ed9906a59ad0a3ea0752061fbf8a9e544f4edd77667a25d85ae
   Copying blob sha256:a1f889dd610c6510c7fc091a51c247463f3cc9a7c67bdc397c9632168808f7d2
   Copying blob sha256:bd278801acd18ada10f43b732113a6fffc163011862ea6cde729f8dc59e64222
   Copying blob sha256:2d6c03ed5d15be86cdef7d9c0c9fea40a3f6b89662bca59680d037074f52bb38
   Copying blob sha256:fa2ef7f80d6fc9543f6eb472846931ed1cec2b5f776d1b67bcb1b9942e1a947e
   Copying blob sha256:ff5a4e4d3690ccc931900b63714d326cc53a58e644f8d0a4f06bf8c62f11c5c7
   Copying config sha256:01aa1ebb7be74529867106100c4e699ca2ae87f8242460771527f772e6a3d174
   Writing manifest to image destination
   Storing signatures
   Successfully pushed us.icr.io/mods15/vmac-openshift-app-registry@sha256:6847b889397704b9fb8c3122c84b505c3dc5f99a0669fb69f534d3504eec385d
   Push successful
   

3. 您可以檢查部署和服務的狀態。

   oc status
   

4. 手動匯入最新映像檔串流，以確保儘快進行部署。

   oc import-image $PRIVREG
   

   如果部署花費更多時間，您也可以使用指令。如需相關資訊，請參閱此 鏈結。

5. 公開服務以建立新的路徑。

   oc expose service/$PRIVREG
   

6. 您可以透過 IBM 提供的網域存取應用程式。 執行以下指令以取得 URL。

   oc get route/$PRIVREG
   

7. 複製 HOST/PORT 值下的主機名稱的值，並將 URL 貼到瀏覽器中，即可在 http://<hostname> 上看到您的應用程式正在運作。 請務必在 URL 中使用 http。

   您應該會看到相同的應用程式公開在不同的路徑上，並使用儲存在專用容器登錄中的容器映像檔進行部署。

建立 Git 部署記號

在本節中，您將建立 Git 部署令牌，以允許唯讀存取您的儲存庫。

若要產生部署標記：

1. 在 Git repo 頁面的導覽面板中，按一下設定 > 儲存庫。
2. 按一下部署記號旁邊的展開。
   1. 在 名稱 欄位中，輸入 foropenshift，然後在 範圍下選取 read_repository。 最後按一下 建立部署記號。
   2. 保存生成的使用者名稱和密碼，以備將來參考。
3. 在導覽面板中，點選專案總覽，然後點選 Clone，複製 Clone with HTTPS URL。 儲存 URL 以供未來參照。
4. 為使用者名稱、密碼和私人 Git repo URL 定義環境變數，以便在稍後的教學中與 YAML 檔案一起使用

   export GIT_TOKEN_USERNAME=<PRIVATE_GIT_DEPLOY_TOKEN_USERNAME>
   export GIT_TOKEN_PASSWORD=<PRIVATE_GIT_DEPLOY_TOKEN_PASSWORD>
   export REPO_URL=<PRIVATE_GIT_REPO_URL>
   

使用專用登錄及專用儲存庫中的程式碼來部署新的應用程式

1. 執行下列 Bash Script，以更新 openshift.template.yaml 檔中的位置保留元，並產生 openshift_private_repository.yaml 檔。

   ./generate_yaml.sh use_private_repository
   

2. 從輸出執行匯出指令，以使用新的專案名稱來設定現有的 MYPROJECT 環境變數。

3. 除了專用儲存器登錄位置保留元之外，該 Script 還會將 BuildConfig 規格下的 REPO_URL 取代為您在上述步驟中設定的環境變數。

    source:
      git:
        uri: $REPO_URL
      type: Git
   

4. 使用更新的 yaml 建立新的 openshift 應用程式，以及 buildconfig(bc)、deploymentconfig(dc)、service(svc)、imagestream(is)

   oc apply -f openshift_private_repository.yaml
   

5. 您可以檢查建置器日誌。

   oc logs -f bc/$PRIVREPO
   

6. 您可以使用此功能檢查部署和服務的狀態。

   oc status
   

7. 手動匯入最新映像檔串流，以確保儘快進行部署。

   oc import-image $PRIVREPO
   

8. 公開服務以建立新的路徑。

   oc expose service/$PRIVREPO
   

9. 您可以透過 IBM 提供的網域存取應用程式。 執行以下指令以取得 URL。

   oc get route/$PRIVREPO
   

10. 複製 HOST/PORT 值下的主機名稱的值，並將 URL 貼到瀏覽器中，即可在 http://<hostname> 上看到您的應用程式正在運作。 請務必在 URL 中使用 http。

    使用專用 Git 儲存庫中的程式碼及專用登錄名稱空間中的容器映像檔來部署新的應用程式。

更新應用程式並重新部署

在此步驟中，您將自動化建置和部署程序。 每當您更新應用程式並將變更推送至專用儲存庫時，即會執行新的建置，以產生新版本的儲存器映像檔。 然後會自動部署此映像檔。

1. 您將建立新的 GitLab Webhook 觸發程式。 Webhook 觸發程式容許您藉由向 Red Hat OpenShift on IBM Cloud Container Platform API 端點傳送要求來觸發新建置。可以使用 GitHub、GitLab、Bitbucket 或通用 Webhook 來定義這些觸發程式。

   oc set triggers bc $PRIVREPO --from-gitlab
   

2. 若要在 GitLab 儲存庫上新增 Webhook，您需要 URL 和密碼

   • 對於 Webhook GitLab URL：

     oc describe bc/$PRIVREPO | grep -A 1 "GitLab"
     

   • 對於需要在 Webhook URL 中傳遞的密碼：

     oc get bc/$PRIVREPO -o yaml | grep -A 3 "\- gitlab"
     

   • **代替 **<secret> 在 webhook GitLab URL 中使用上面指令輸出中的 gitlab 下的 secret 值。

3. 使用 Git repo HTTPS 連結在瀏覽器中開啟您的私人 git repo，然後按一下設定，再按一下 Webhooks。

4. 貼上 URL，選擇推送事件 為觸發器，然後按一下新增 webhook。 您應該會看到 Webhook was created 訊息。

5. 更新映像檔串流的 ImagePolicy，以按預定時間間隔查詢 Container Registry 來同步標籤和映像檔 meta 資料。 這將更新 tags 定義。

   oc tag $MYREGISTRY/$MYNAMESPACE/${PRIVREPO}:latest ${PRIVREPO}:latest --scheduled=true
   

6. 在 IDE 中開啟已複製的套件庫，更新本機檔案的 h1 標籤，並變更為。public/index.html 檔案的標籤，並將其變更為 Congratulations! <insert your name>。

7. 儲存並將程式碼推送至儲存庫。

    git add public/index.html
   

    git commit -m "Updated with my name"
   

    git push -u origin master
   

8. 可以使用 oc status 指令來檢查建置和部署的進度。 部署成功後，請重新整理路徑主機位址以查看更新的 Web 應用程式。

   有時，部署可能最長需要 15 分鐘才能匯入最新的映像檔串流。 您可以等待或使用 oc import-image $PRIVREPO 指令手動匯入。 如需相關資訊，請參閱此 鏈結。

使用 HTTP

1. 以您的主機名稱 (例如 www.example.com 或 openshiftapp.example.com ) 取代 <HOSTNAME>，建立一個路由，以主機名稱揭露服務，這樣外部用戶端就可以透過名稱存取服務。

   oc expose svc/$PRIVREPO --hostname=<HOSTNAME> --name=$PRIVREPO-domain --port=3000
   

2. 從以下網址存取您的申請表 http://<HOSTNAME>/

使用 HTTPS

1. 要建立安全的 HTTPS 路由，您可以使用自己的憑證和來自 Let's Encrypt 等 CA 的金鑰檔案，或透過以下方式訂購 Secrets Manager. 請使用 create route 指令傳遞它們。

   oc create route edge $PRIVREPO-httpsca --service=$PRIVREPO --cert=example.pem --key=example.key --hostname=<www.HOSTNAME> --port=3000
   

   在此，您使用了邊緣終止。 若要瞭解其他安全路徑及終止類型 (例如透通及重新加密)，請執行 oc create route --help 指令)