安装 GitOps
安装 OpenShift GitOps Operator 并登录到 Argo CD 实例
摘要
第 1 章 准备安装 Red Hat OpenShift GitOps 复制链接链接已复制到粘贴板!
在 OpenShift Container Platform 上安装 Red Hat OpenShift GitOps 前,请阅读以下有关大小要求和先决条件的信息。大小要求还提供由 Red Hat OpenShift GitOps Operator 实例化的默认 ArgoCD 实例的大小详情。
1.1. GitOps 的大小要求 复制链接链接已复制到粘贴板!
Red Hat OpenShift GitOps 是为云原生应用程序实施持续部署的一种声明方法。通过 GitOps,您可以定义并配置应用程序的 CPU 和内存要求。
每次安装 Red Hat OpenShift GitOps Operator 时,命名空间上的资源都会在定义的限制中安装。如果默认安装没有设置任何限制或请求,Operator 会使用配额在命名空间中失败。如果没有足够资源,集群无法调度 ArgoCD 相关 pod。下表列出了默认工作负载的资源请求和限值:
| Workload | CPU 请求 | CPU 限值 | 内存请求 | 内存限值 |
|---|---|---|---|---|
| argocd-application-controller | 1 | 2 | 1024M | 2048M |
| applicationset-controller | 1 | 2 | 512M | 1024M |
| argocd-server | 0.125 | 0.5 | 128M | 256M |
| argocd-repo-server | 0.5 | 1 | 256M | 1024M |
| argocd-redis | 0.25 | 0.5 | 128M | 256M |
| argocd-dex | 0.25 | 0.5 | 128M | 256M |
| HAProxy | 0.25 | 0.5 | 128M | 256M |
另外,您还可以在 oc 命令中使用 ArgoCD 自定义资源来查看特定并修改它们:
oc edit argocd <name of argo cd> -n namespace
oc edit argocd <name of argo cd> -n namespace
第 2 章 安装 Red Hat OpenShift GitOps 复制链接链接已复制到粘贴板!
Red Hat OpenShift GitOps 使用 Argo CD 管理特定集群范围的资源,包括:集群 Operator、可选 Operator Lifecycle Manager(OLM)Operator 和用户管理。
2.1. 前提条件 复制链接链接已复制到粘贴板!
- 访问 OpenShift Container Platform web 控制台。
-
以具有
cluster-admin角色的用户身份登录。 - 以管理员身份登陆到 OpenShift Container Platform 集群。
- 您的集群启用了 Marketplace 功能,或者手动配置 Red Hat Operator 目录源。
如果您已安装 Argo CD Operator 的 Community 版本,请在安装 Red Hat OpenShift GitOps Operator 前删除 Argo CD Community Operator。
本指南介绍如何将 Red Hat OpenShift GitOps Operator 安装到 OpenShift Container Platform 集群,并登录 Argo CD 实例。
latest 频道启用 Red Hat OpenShift GitOps Operator 最新稳定版本的安装。目前,这是安装 Red Hat OpenShift GitOps Operator 的默认频道。
要安装 Red Hat OpenShift GitOps Operator 的特定版本,集群管理员可以使用对应的 gitops-<version> 频道。例如,要安装 Red Hat OpenShift GitOps Operator 版本 1.8.x,您可以使用 gitops-1.8 频道。
2.2. 在 Web 控制台中安装 Red Hat OpenShift GitOps Operator 复制链接链接已复制到粘贴板!
您可以使用 Web 控制台从 OperatorHub 安装 Red Hat OpenShift GitOps Operator。
流程
- 打开 Web 控制台的 Administrator 视角,再进入 Operators → OperatorHub。
-
搜索
OpenShift GitOps,点 Red Hat OpenShift GitOps 标题,然后点 Install。 在 Install Operator 页面中:
- 选择一个 更新频道。
- 选择要安装的 GitOps Version。
选择 Installed Namespace。默认安装命名空间为
openshift-gitops-operator。注意对于 GitOps 版本 1.10 及更新的版本,默认命名空间从
openshift-operators改为openshift-gitops operator。选择 Enable Operator recommended cluster monitoring on this Namespace 复选框来启用集群监控。
注意您可以通过应用
openshift.io/cluster-monitoring=true标签来在任何命名空间中启用集群监控:oc label namespace <namespace> openshift.io/cluster-monitoring=true
$ oc label namespace <namespace> openshift.io/cluster-monitoring=trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
namespace/<namespace> labeled
namespace/<namespace> labeledCopy to Clipboard Copied! Toggle word wrap Toggle overflow
点 Install 使 GitOps Operator 在 OpenShift Container Platform 集群上可用。
Red Hat OpenShift GitOps 安装在集群的所有命名空间中。
- 验证 Red Hat OpenShift GitOps Operator 是否列在 Operators → Installed Operators 中。状态 应变为 Succeeded。
安装 Red Hat OpenShift GitOps Operator 后,它会自动设置 openshift-gitops 命名空间中的已就绪的 Argo CD 实例,并在控制台工具栏中显示 Argo CD 图标。您可以在项目下为您的应用程序创建后续的 Argo CD 实例。
2.3. 使用 CLI 安装 Red Hat OpenShift GitOps Operator 复制链接链接已复制到粘贴板!
您可以使用 CLI 从 OperatorHub 安装 Red Hat OpenShift GitOps Operator。
对于 GitOps 版本 1.10 及更新的版本,默认命名空间从 openshift-operators 改为 openshift-gitops operator。
流程
创建
openshift-gitops-operator命名空间:oc create ns openshift-gitops-operator
$ oc create ns openshift-gitops-operatorCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
namespace/openshift-gitops-operator created
namespace/openshift-gitops-operator createdCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注意您可以通过应用
openshift.io/cluster-monitoring=true标签,在openshift-gitops-operator或任何命名空间上启用集群监控:oc label namespace <namespace> openshift.io/cluster-monitoring=true
$ oc label namespace <namespace> openshift.io/cluster-monitoring=trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
namespace/<namespace> labeled
namespace/<namespace> labeledCopy to Clipboard Copied! Toggle word wrap Toggle overflow 创建
OperatorGroup对象 YAML 文件,例如gitops-operator-group.yaml:OperatorGroup 示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 将
OperatorGroup应用到集群:oc apply -f gitops-operator-group.yaml
$ oc apply -f gitops-operator-group.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
operatorgroup.operators.coreos.com/openshift-gitops-operator created
operatorgroup.operators.coreos.com/openshift-gitops-operator createdCopy to Clipboard Copied! Toggle word wrap Toggle overflow 创建一个
Subscription对象 YAML 文件,以便为 Red Hat OpenShift GitOps Operator 订阅一个命名空间,如openshift-gitops-sub.yaml:订阅示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 将
订阅应用到集群:oc apply -f openshift-gitops-sub.yaml
$ oc apply -f openshift-gitops-sub.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
subscription.operators.coreos.com/openshift-gitops-operator created
subscription.operators.coreos.com/openshift-gitops-operator createdCopy to Clipboard Copied! Toggle word wrap Toggle overflow 安装完成后,验证
openshift-gitops命名空间中的所有 pod 是否正在运行:oc get pods -n openshift-gitops
$ oc get pods -n openshift-gitopsCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 验证
openshift-gitops-operator命名空间中的 pod 是否正在运行:oc get pods -n openshift-gitops-operator
$ oc get pods -n openshift-gitops-operatorCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
NAME READY STATUS RESTARTS AGE openshift-gitops-operator-controller-manager-664966d547-vr4vb 2/2 Running 0 65m
NAME READY STATUS RESTARTS AGE openshift-gitops-operator-controller-manager-664966d547-vr4vb 2/2 Running 0 65mCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.4. 使用 Argo CD admin 帐户登录到 Argo CD 实例 复制链接链接已复制到粘贴板!
Red Hat OpenShift GitOps Operator 会自动创建一个可用的 Argo CD 实例,可在 openshift-gitops 命名空间中使用。
先决条件
- 在集群中安装了 Red Hat OpenShift GitOps Operator。
流程
- 在 Web 控制台的 Administrator 视角中,导航到 Operators → Installed Operators,以验证是否安装了 Red Hat OpenShift GitOps Operator。
-
进入
menu → OpenShift GitOps → Cluster Argo CD。Argo CD UI 的登录页面显示在新窗口中。
可选: 要使用 OpenShift Container Platform 凭证登录,请确保您是
cluster-admins组的用户,然后在 Argo CD 用户界面中选择LOG IN VIA OPENSHIFT选项。注意要是
cluster-admins组的用户,请使用oc adm groups new cluster-admins <user> 命令,其中 <user> 是您可以绑定到集群范围或本地的用户和组的默认集群角色。要使用您的用户名和密码登录,请获取 Argo CD 实例的密码:
- 在控制台左侧面板中,使用视角切换器切换到 Developer 视角。
-
使用 Project 下拉列表,再选择
openshift-gitops项目。 - 使用左侧导航面板导航到 Secrets 页面。
- 选择 openshift-gitops-cluster 实例来显示密码。
- 复制密码。
-
使用此密码和
admin作为用户名在新窗口中登录到 Argo CD UI。
您不能在同一命名空间中创建两个 Argo CD CR。