第 2 章 安装 Dev Spaces
本节包含安装 Red Hat OpenShift Dev Spaces 的说明。
您只能为每个集群部署一个 OpenShift Dev Spaces 实例。
2.1. 在云中安装 Dev Spaces
在云中部署和运行 Red Hat OpenShift Dev Spaces。
先决条件
- 用于部署 OpenShift Dev Spaces 的 OpenShift 集群。
-
DSC
: Red Hat OpenShift Dev Spaces 的命令行工具。请参阅:第 1.2 节 “安装 dsc 管理工具”。
2.1.1. 在云中部署 OpenShift Dev Spaces
按照以下说明,使用 dsc
工具启动云中的 OpenShift Dev Spaces 服务器。
2.1.2. 使用 CLI 在 OpenShift 上安装 Dev Spaces
您可以在 OpenShift 上安装 OpenShift Dev Spaces。
先决条件
- OpenShift Container Platform
-
具有 OpenShift 集群管理权限的活跃的
oc
会话。请参阅 OpenShift CLI 入门。 -
DSC
.请参阅:第 1.2 节 “安装 dsc 管理工具”。
流程
可选:如果您之前在此 OpenShift 集群中部署了 OpenShift Dev Spaces,请确保删除了以前的 OpenShift Dev Spaces 实例:
$ dsc server:delete
创建 OpenShift Dev Spaces 实例:
$ dsc server:deploy --platform openshift
验证步骤
验证 OpenShift Dev Spaces 实例状态:
$ dsc server:status
进入到 OpenShift Dev Spaces 集群实例:
$ dsc dashboard:open
2.1.3. 使用 Web 控制台在 OpenShift 上安装 Dev Spaces
如果在 命令行 上安装 OpenShift Dev Spaces 时遇到问题,您可以通过 OpenShift Web 控制台安装它。
先决条件
- 集群管理员的 OpenShift Web 控制台会话。请参阅 访问 Web 控制台。
-
具有 OpenShift 集群管理权限的活跃的
oc
会话。请参阅 OpenShift CLI 入门。 - 要在同一 OpenShift 集群上重复安装:您可以根据 第 8 章 卸载 Dev Spaces 卸载之前的 OpenShift Dev Spaces 实例。
流程
-
在 OpenShift Web 控制台的 Administrator 视图中,进入 Operators
OperatorHub 并搜索 Red Hat OpenShift Dev Spaces
。 安装 Red Hat OpenShift Dev Spaces Operator。
提示请参阅使用 Web 控制台从 OperatorHub 安装。
小心Red Hat OpenShift Dev Spaces Operator 依赖于 Dev Workspace Operator。如果您手动将 Red Hat OpenShift Dev Spaces Operator 安装到非默认命名空间中,请确保同时安装了 Dev Workspace Operator。这是必需的,因为 Operator Lifecycle Manager 将尝试将 Dev Workspace Operator 作为 Red Hat OpenShift Dev Spaces Operator 命名空间中的依赖项安装,如果后者在不同的命名空间中安装,可能会导致 Dev Workspace Operator 的两个冲突安装。
如果要在集群中加入 Web Terminal Operator,请确保使用与 Red Hat OpenShift Dev Spaces Operator 相同的安装命名空间,因为它们都依赖于 Dev Workspace Operator。Web Terminal Operator、Red Hat OpenShift Dev Spaces Operator 和 Dev Workspace Operator 必须安装在同一个命名空间中。
在 OpenShift 中创建
openshift-devspaces
项目,如下所示:oc create namespace openshift-devspaces
-
进入 Operators
Installed Operators Red Hat OpenShift Dev Spaces 实例 Specification Create CheCluster YAML view。 -
在 YAML 视图中,将
namespace: openshift-operators
替换为namespace: openshift-devspaces
。 选择 Create。
提示
验证
- 在 Red Hat OpenShift Dev Spaces 实例规格中,进入 devspaces,在 Details 标签页中登录。
- 在 Message 下,检查是否有 None,这表示没有任何错误。
- 在 Red Hat OpenShift Dev Spaces URL 下,等待 OpenShift Dev Spaces 实例的 URL 出现,然后打开 URL 以检查 OpenShift Dev Spaces 仪表板。
- 在 Resources 选项卡中,查看 OpenShift Dev Spaces 部署的资源及其状态。
2.1.4. 在受限环境中安装 Dev Spaces
在受限网络中运行的 OpenShift 集群上,无法使用公共资源。
但是,部署 OpenShift Dev Spaces 并运行工作区需要以下公共资源:
- Operator 目录
- 容器镜像
- 示例项目
要使这些资源可用,您可以将它们替换为 OpenShift 集群可访问的注册表中的副本。
先决条件
- OpenShift 集群至少有 64 GB 磁盘空间。
- OpenShift 集群已准备好在受限网络中运行,OpenShift control plane 可以访问互联网。请参阅关于断开连接的安装镜像,以及 在受限网络中使用 Operator Lifecycle Manager。
-
具有 OpenShift 集群管理权限的活跃的
oc
会话。请参阅 OpenShift CLI 入门。 -
到
registry.redhat.io
红帽生态系统目录的一个活跃的oc registry
会话。请参阅: Red Hat Container Registry 身份验证。
-
opm
.请参阅安装opm
CLI。 -
jq
.请参阅 下载jq
。 -
Podman
.请参阅 Podman 安装说明。 -
Skopeo
版本 1.6 或更高版本。请参阅 安装 Skopeo。 -
一个活跃的
skopeo
会话,具有对私有 Docker registry 的管理访问权限。对 registry 进行身份验证 ,并为断开连接的安装 mirror 镜像。 -
用于
OpenShift Dev Spaces 版本 3.15 的 DSC。请参阅 第 1.2 节 “安装 dsc 管理工具”。
流程
下载并执行镜像脚本,以安装自定义 Operator 目录并镜像相关镜像: prepare-restricted-environment.sh。
$ bash prepare-restricted-environment.sh \ --devworkspace_operator_index registry.redhat.io/redhat/redhat-operator-index:v4.16\ --devworkspace_operator_version "v0.29.0" \ --prod_operator_index "registry.redhat.io/redhat/redhat-operator-index:v4.16" \ --prod_operator_package_name "devspaces" \ --prod_operator_bundle_name "devspacesoperator" \ --prod_operator_version "v3.15.0" \ --my_registry "<my_registry>" 1
- 1
- 镜像要镜像的专用 Docker registry
使用上一步中
che-operator-cr-patch.yaml
中设置的配置安装 OpenShift Dev Spaces:$ dsc server:deploy \ --platform=openshift \ --olm-channel stable \ --catalog-source-name=devspaces-disconnected-install \ --catalog-source-namespace=openshift-marketplace \ --skip-devworkspace-operator \ --che-operator-cr-patch-yaml=che-operator-cr-patch.yaml
- 允许来自 OpenShift Dev Spaces 命名空间中的传入流量到用户项目中的所有 Pod。请参阅:第 3.8.1 节 “配置网络策略”。
其他资源
2.1.4.1. 设置 Ansible 示例
按照以下步骤在受限环境中使用 Ansible 示例。
先决条件
- Microsoft Visual Studio Code - 开源 IDE
- 64 位 x86 系统。
流程
镜像以下镜像:
ghcr.io/ansible/ansible-workspace-env-reference@sha256:03d7f0fe6caaae62ff2266906b63d67ebd9cf6e4a056c7c0a0c1320e6cfbebce registry.access.redhat.com/ubi8/python-39@sha256:301fec66443f80c3cc507ccaf72319052db5a1dc56deb55c8f169011d4bbaacb
配置集群代理以允许访问以下域:
.ansible.com .ansible-galaxy-ng.s3.dualstack.us-east-1.amazonaws.com
计划在以后的版本中对以下 IDE 和 CPU 架构的支持:
IDE
- JetBrains IntelliJ IDEA 社区版 IDE (技术预览)
CPU 架构
- IBM Power (ppc64le)
- IBM Z (s390x)