Navigation Menu

Skip to content

Commit

Permalink
1. 3.4分支补充升级内容;2. 统一替换成云联壹云;
Browse files Browse the repository at this point in the history
  • Loading branch information
董丽萍 committed Oct 20, 2020
1 parent 8026fa7 commit e1d95c4
Show file tree
Hide file tree
Showing 28 changed files with 217 additions and 95 deletions.
4 changes: 2 additions & 2 deletions README.md
@@ -1,6 +1,6 @@
# Yunion OneCloud 文档
# 云联壹云 文档

本仓库包含 Yunion OneCloud 相关的文档
本仓库包含 云联壹云 相关的文档

## 安装 hugo

Expand Down
16 changes: 8 additions & 8 deletions content/zh/docs/_index.md
@@ -1,36 +1,36 @@
---
title: "欢迎来到 OneCloud"
title: "欢迎来到 云联壹云"
linkTitle: "文档"
menu:
main:
weight: 20
---

欢迎查看 OneCloud 文档,本文档会介绍 OneCloud 服务安装部署、资源操作管理和开发贡献等内容。
欢迎查看 云联壹云 文档,本文档会介绍 云联壹云 服务安装部署、资源操作管理和开发贡献等内容。

## 什么是 OneCloud?
## 什么是 云联壹云?

OneCloud 是一个开源的多云平台。构建在用户分布于多云基础设施之上,通过技术手段将分分布于多云的异构IT资源统一管理,将多底层多云的差异向用户屏蔽,并通过网络和调度实现资源的融合与打通,在多云之上进行抽象,向用户呈现统一的使用界面和API接口,让用户就像使用一个云平台一样使用分布于多云的资源,实现一个统一的“云上之云”的云平台。
云联壹云 是一个开源的多云平台。构建在用户分布于多云基础设施之上,通过技术手段将分分布于多云的异构IT资源统一管理,将多底层多云的差异向用户屏蔽,并通过网络和调度实现资源的融合与打通,在多云之上进行抽象,向用户呈现统一的使用界面和API接口,让用户就像使用一个云平台一样使用分布于多云的资源,实现一个统一的“云上之云”的云平台。

OneCloud 具备以下功能特性:
云联壹云 具备以下功能特性:

- **多云资源统一管理**

统一API、镜像、调度、账号体系、监控和计费等操作,能够全面管理 On premises、 私有云、公有云资源。

- **内置私有云**

OneCloud内置完备的私有云实现,提供对用户本地IDC的虚拟机、物理机和负载均衡等资源管理。
云联壹云内置完备的私有云实现,提供对用户本地IDC的虚拟机、物理机和负载均衡等资源管理。

- **为多云Kubernetes提供运行环境**

OneCloud自身为运行在Kubernetes的云原生应用,并且能在多云环境部署运行Kubernetes集群。
云联壹云自身为运行在Kubernetes的云原生应用,并且能在多云环境部署运行Kubernetes集群。

## 从哪开始?

文档分为以下部分:

- [安装部署](/docs/setup/): 安装和部署 onecloud 各个服务与组件
- [安装部署](/docs/setup/): 安装和部署 云联壹云 各个服务与组件

- [开发贡献](/docs/contribute/): 搭建开发环境,提交 PR

Expand Down
8 changes: 4 additions & 4 deletions content/zh/docs/contribute/contrib.md
Expand Up @@ -29,7 +29,7 @@ apt-get update && apt-get install -y libcephfs-dev librbd-dev librados-dev
```


## 编译 onecloud 组件
## 编译 云联壹云 组件

### Fork 仓库

Expand Down Expand Up @@ -71,7 +71,7 @@ region host

### 安装

确保有一个已部署的onecloud k8s集群,参考[安装部署](/docs/setup/)
确保有一个已部署的云联壹云 k8s集群,参考[安装部署](/docs/setup/)
这里介绍Centos7的本地环境安装,其他发行版可参考官方文档:[Installing Telepresence](https://www.telepresence.io/reference/install)

> 不建议k8s集群的部署和开发在同一个环境,使用Telepresence会有端口冲突。
Expand Down Expand Up @@ -104,7 +104,7 @@ $ sudo env PREFIX=/usr/local ./install.sh

比如以下是本地编译运行 region 服务的流程:
```bash
# 切换到 onecloud 代码目录
# 切换到 云联壹云 代码目录
$ cd $GOPATH/src/yunion.io/x/onecloud

# 编译 region 服务
Expand Down Expand Up @@ -132,7 +132,7 @@ $ unshare --map-root-user --mount
$ mount --bind $TELEPRESENCE_ROOT/var/run /var/run
$ ls /var/run/
secrets
# bind onecloud config
# bind 云联壹云 config
$ mkdir /etc/yunion
$ mount --bind $TELEPRESENCE_ROOT/etc/yunion /etc/yunion
$ ls /etc/yunion/
Expand Down
2 changes: 1 addition & 1 deletion content/zh/docs/contribute/framework.md
Expand Up @@ -22,7 +22,7 @@ keystone, region, glance 等后端服务,都是用的同一套后端服务框

- Task: 后台处理异步耗时任务的模块,会通过更新 Model 的状态来更新任务的执行结果。

## onecloud 代码结构
## 云联壹云 代码结构

- [build](https://github.com/yunionio/onecloud/tree/master/build): 打包rpm脚本
- [cmd](https://github.com/yunionio/onecloud/tree/master/cmd): 可执行binary入口程序
Expand Down
2 changes: 1 addition & 1 deletion content/zh/docs/contribute/services.md
Expand Up @@ -7,7 +7,7 @@ description: >

## 架构简介

OneCloud 服务组件较多,接下来分别介绍每个组件的功能:
云联壹云 服务组件较多,接下来分别介绍每个组件的功能:

| 服务组件 | 功能用途 |
|------------|----------------------------------------|
Expand Down
2 changes: 1 addition & 1 deletion content/zh/docs/howto/_index.md
Expand Up @@ -32,6 +32,6 @@ description:
| 名称 | 资源 | 作用 | 类型 |
|--------------|--------------|------------------------------------|-------|
| cloudaccount | 云平台的账户 | 对应各个云平台的认证信息 | infra |
| project | 项目 | OneCloud 内部对虚拟机资源的划分 | infra |
| project | 项目 | 云联壹云 内部对虚拟机资源的划分 | infra |
| schedtag | 调度标签 | 可以标记多种资源,提供资源调度能力 | infra |
| sku | 套餐信息 | 对应创建虚拟资源的规格信息 | infra |
2 changes: 1 addition & 1 deletion content/zh/docs/howto/climc/_index.md
Expand Up @@ -6,7 +6,7 @@ weight: 1

云平台的命令行管理工具是 `climc`, 可以通过该工具向后端各个服务发送API请求, 实现对资源的操控。

通过快速开始的[All in One安装](../../quickstart/allinone/)[安装部署](../../setup)章节搭建开源版OneCloud环境时,控制节点都会安装climc,可直接跳过安装climc章节直接查看使用climc章节。
通过快速开始的[All in One安装](../../quickstart/allinone/)[安装部署](../../setup)章节搭建开源版云联壹云环境时,控制节点都会安装climc,可直接跳过安装climc章节直接查看使用climc章节。

下面介绍如何在非控制节点上安装climc。

Expand Down
4 changes: 2 additions & 2 deletions content/zh/docs/howto/host/_index.md
Expand Up @@ -8,8 +8,8 @@ weight: 20

| 类型 | 平台 |
|:----------:|:----------------------:|
| hypervisor | onecloud 私有云宿主机 |
| baremetal | onecloud 私有云物理机 |
| hypervisor | 云联壹云 私有云宿主机 |
| baremetal | 云联壹云 私有云物理机 |
| esxi | vmware 宿主机 |
| openstack | openstack 私有云宿主机 |
| zstack | zstack 私有云宿主机 |
2 changes: 1 addition & 1 deletion content/zh/docs/howto/host/kvm.md
Expand Up @@ -4,7 +4,7 @@ weight: 1
date: 2019-07-19T20:00:14+08:00
---

OneCloud 原生提供基于 kvm 的私有云虚拟机管理功能,运行 kvm 虚拟机的机器叫做宿主机,这种宿主机也叫作 "计算节点",上面会运行管理虚拟机、网络和存储的一系列服务,如何部署并上线宿主机请参考: [安装部署/计算节点](/setup/host/)
云联壹云 原生提供基于 kvm 的私有云虚拟机管理功能,运行 kvm 虚拟机的机器叫做宿主机,这种宿主机也叫作 "计算节点",上面会运行管理虚拟机、网络和存储的一系列服务,如何部署并上线宿主机请参考: [安装部署/计算节点](/setup/host/)

## 宿主机操作

Expand Down
2 changes: 1 addition & 1 deletion content/zh/docs/howto/image/_index.md
Expand Up @@ -14,6 +14,6 @@ image 和 cached-image 两种资源的区别如下:

- image: glance 管理的镜像,由用户上传或者外部导入;
- cached-image:
- 包括公有云和其他私有云的镜像,不由 glance 管理,一般在创建 OneCloud 之外的公/私有云主机的时候用到;
- 包括公有云和其他私有云的镜像,不由 glance 管理,一般在创建 云联壹云 之外的公/私有云主机的时候用到;
- 不提供创建接口,只能查询,刷新和删除;

4 changes: 2 additions & 2 deletions content/zh/docs/howto/server/_index.md
Expand Up @@ -15,8 +15,8 @@ weight: 10

| 类型 | 平台 |
|:---------:|:----------------------:|
| kvm | onecloud 私有云虚拟机 |
| baremetal | onecloud 私有云裸金属 |
| kvm | 云联壹云 私有云虚拟机 |
| baremetal | 云联壹云 私有云裸金属 |
| esxi | vmware 虚拟机 |
| openstack | openstack 私有云虚拟机 |
| zstack | zstack 私有云虚拟机 |
Expand Down
8 changes: 4 additions & 4 deletions content/zh/docs/howto/server/create/_index.md
Expand Up @@ -4,22 +4,22 @@ weight: 10
date: 2019-07-19T15:22:33+08:00
---

`climc server-create` 命令提供创建云主机的操作。 OneCloud 可以同时管理多个私有云和公有云,不同供应商有各自的认证方式,在创建云主机之前需要做一些不同的准备工作。
`climc server-create` 命令提供创建云主机的操作。 云联壹云 可以同时管理多个私有云和公有云,不同供应商有各自的认证方式,在创建云主机之前需要做一些不同的准备工作。


## 环境准备

### OneCloud 虚拟机
### 云联壹云 虚拟机

OneCloud 提供自研的 kvm 虚拟机私有云管理平台,创建 kvm 虚拟机时需要有相应的宿主机,如果还没有添加 kvm 宿主机,请参考 [安装部署/计算节点](../../../setup/host/) 注册对应的宿主机到云平台。
云联壹云 提供自研的 kvm 虚拟机私有云管理平台,创建 kvm 虚拟机时需要有相应的宿主机,如果还没有添加 kvm 宿主机,请参考 [安装部署/计算节点](../../../setup/host/) 注册对应的宿主机到云平台。

### VMware ESXI 虚拟机

TODO

### 私有云

私有云和公有云都有自己的认证体系,为了让 OneCloud 能够管理各个云平台,需要把他们的认证信息导入到 OneCloud 平台。
私有云和公有云都有自己的认证体系,为了让 云联壹云 能够管理各个云平台,需要把他们的认证信息导入到 云联壹云 平台。

| 平台 | 准备工作 |
|:---------:|:--------:|
Expand Down
4 changes: 2 additions & 2 deletions content/zh/docs/howto/server/create/kvm.md
@@ -1,8 +1,8 @@
---
title: "OneCloud 虚拟机"
title: "云联壹云 虚拟机"
date: 2019-07-19T15:25:57+08:00
weight: 1
draft: true
---

OneCloud 提供自研的 kvm 虚拟机私有云管理平台,创建 kvm 虚拟机时需要有相应的宿主机,如果还没有添加 kvm 宿主机,请参考 [安装部署/计算节点](/setup/host/) 注册对应的宿主机到云平台。
云联壹云 提供自研的 kvm 虚拟机私有云管理平台,创建 kvm 虚拟机时需要有相应的宿主机,如果还没有添加 kvm 宿主机,请参考 [安装部署/计算节点](/setup/host/) 注册对应的宿主机到云平台。
2 changes: 1 addition & 1 deletion content/zh/docs/howto/server/gpu.md
Expand Up @@ -4,7 +4,7 @@ date: 2019-07-19T18:32:40+08:00
weight: 40
---

目前仅支持 OneCloud kvm 虚拟机使用 GPU,使用的 PCI Passthrough 的方式将宿主机上的 Nvidia/AMD GPU 透传给虚拟机使用。
目前仅支持 云联壹云 kvm 虚拟机使用 GPU,使用的 PCI Passthrough 的方式将宿主机上的 Nvidia/AMD GPU 透传给虚拟机使用。

## 相关操作

Expand Down
2 changes: 1 addition & 1 deletion content/zh/docs/howto/server/import.md
Expand Up @@ -4,7 +4,7 @@ date: 2019-11-26T16:57:43+08:00
weight: 40
---

支持将libvirt管理的虚拟机导入到OneCloud
支持将libvirt管理的虚拟机导入到云联壹云平台。

## 注意事项

Expand Down
2 changes: 1 addition & 1 deletion content/zh/docs/quickstart/_index.md
Expand Up @@ -3,5 +3,5 @@ title: "快速开始"
linkTitle: "快速开始"
weight: -1
description: >
介绍如何快速部署体验 onecloud 服务
介绍如何快速部署体验 云联壹云 服务
---
28 changes: 14 additions & 14 deletions content/zh/docs/quickstart/allinone.md
Expand Up @@ -3,18 +3,18 @@ title: "All in One 安装"
linkTitle: "All in One 安装"
weight: 1
description: >
使用 ansible 安装脚本快速在已有的 Centos 7 虚拟机上 All in One 部署 OneCloud 服务
使用 ansible 安装脚本快速在已有的 Centos 7 虚拟机上 All in One 部署 云联壹云 服务
---

## 前提

{{% alert title="注意" color="warning" %}}
本章内容是通过部署工具快速搭建 OneCloud 服务,如果想了解部署的细节或者部署高可用环境请参考: [安装部署](/docs/setup/)
本章内容是通过部署工具快速搭建 云联壹云 服务,如果想了解部署的细节或者部署高可用环境请参考: [安装部署](/docs/setup/)
{{% /alert %}}

## 环境准备

OneCloud 相关的组件运行在 kubernetes 之上。
云联壹云 相关的组件运行在 kubernetes 之上。

### 服务器配置要求

Expand All @@ -31,7 +31,7 @@ OneCloud 相关的组件运行在 kubernetes 之上。
> 10.168.26.216 是本次测试环境 ip,请根据自己的环境做相应修改。
{{% /alert %}}

### OneCloud相关软件依赖
### 云联壹云相关软件依赖

- 数据库: mariadb Ver 15.1 Distrib 5.5.56-MariaDB
- docker: ce-19.03.9
Expand Down Expand Up @@ -59,7 +59,7 @@ $ ssh root@10.168.26.216 "hostname"

## 开始部署

部署的工具是 https://github.com/yunionio/ocboot , 然后根据需要部署机器的配置, 利用 ansbile 远程登录到待部署的机器安装配置 onecloud 服务,以下操作都在本地环境上进行操作。操作步骤如下:
部署的工具是 https://github.com/yunionio/ocboot , 然后根据需要部署机器的配置, 利用 ansbile 远程登录到待部署的机器安装配置 云联壹云 服务,以下操作都在本地环境上进行操作。操作步骤如下:

### 下载 ocboot

Expand All @@ -86,7 +86,7 @@ mariadb_node:
db_user: root
# mariadb 用户密码
db_password: your-sql-password
# primary_master_node 表示运行 k8s 和 onecloud 服务的节点
# primary_master_node 表示运行 k8s 和 云联壹云 服务的节点
primary_master_node:
hostname: 10.168.26.216
user: root
Expand All @@ -100,11 +100,11 @@ primary_master_node:
controlplane_host: 10.168.26.216
# k8s 控制节点的端口
controlplane_port: "6443"
# onecloud 登录用户
# 云联壹云 登录用户
onecloud_user: admin
# onecloud 登录用户密码
# 云联壹云 登录用户密码
onecloud_user_password: admin@123
# 该节点作为 OneCloud 私有云计算节点
# 该节点作为 云联壹云 私有云计算节点
as_host: true
EOF
```
Expand All @@ -126,20 +126,20 @@ User: admin
Password: admin@123
```

然后用浏览器访问 https://10.168.26.216 ,用户名输入 `admin`,密码输入 `admin@123` 就会进入 OneCloud 的界面。
然后用浏览器访问 https://10.168.26.216 ,用户名输入 `admin`,密码输入 `admin@123` 就会进入 云联壹云 的界面。

![登录页](../images/index.png)

## FAQ

### 1. 在 All in One 中找不到虚拟机界面?

All in One 部署的节点会部署 OneCloud host 计算服务,作为宿主机,具有创建和管理私有云虚拟机的能力。没有虚拟机界面应该是 OneCloud 环境中没有启用宿主机。
All in One 部署的节点会部署 云联壹云 host 计算服务,作为宿主机,具有创建和管理私有云虚拟机的能力。没有虚拟机界面应该是 云联壹云 环境中没有启用宿主机。

请到 `管理后台` 界面,点击 `主机/基础资源/宿主机` 查看宿主机列表,启用相应的宿主机,刷新界面就会出现虚拟机界面。

{{% alert title="注意" color="warning" %}}
如果要使用 OneCloud 私有云虚拟机,需要宿主机使用 OneCloud 编译的内核,可使用以下命令查看宿主机是否使用 OneCloud 内核(包含 yn 关键字)。
如果要使用 云联壹云 私有云虚拟机,需要宿主机使用 云联壹云 编译的内核,可使用以下命令查看宿主机是否使用 云联壹云 内核(包含 yn 关键字)。

```bash
# 查看是否使用 yn 内核
Expand All @@ -154,10 +154,10 @@ $ reboot

### 2. 如何导入公有云或者其它私有云平台资源?

`多云管理` 菜单,选择 `云账号` 并新建,根据自己的需求填写对应云平台的认证信息,配置完云账号后 OneCloud 服务就会同步相应云平台的资源,同步完成后即可在前端查看。
`多云管理` 菜单,选择 `云账号` 并新建,根据自己的需求填写对应云平台的认证信息,配置完云账号后 云联壹云 服务就会同步相应云平台的资源,同步完成后即可在前端查看。

![多云管理](../images/cloudaccount.png)

### 3. 其它问题?

其它问题欢迎在 OneCloud github issues 界面提交: https://github.com/yunionio/onecloud/issues , 我们会尽快回复。
其它问题欢迎在 云联壹云 github issues 界面提交: https://github.com/yunionio/onecloud/issues , 我们会尽快回复。
16 changes: 8 additions & 8 deletions content/zh/docs/quickstart/minikube.md
Expand Up @@ -3,16 +3,16 @@ title: "MiniKube 安装"
linkTitle: "MiniKube 安装"
weight: 1
description: >
使用MiniKube,快速部署体验单机版本的OneCloud服务
使用MiniKube,快速部署体验单机版本的云联壹云服务
---

## 前提
{{% alert title="注意" color="warning" %}}
本章内容是方便快速体验OneCloud, 通过MiniKube快速搭建OneCloud服务,如果想了解部署的细节或者部署高可用环境请参考: [安装部署](/docs/setup/)
本章内容是方便快速体验云联壹云, 通过MiniKube快速搭建云联壹云服务,如果想了解部署的细节或者部署高可用环境请参考: [安装部署](/docs/setup/)
{{% /alert %}}

## 环境准备
OneCloud 相关的组件运行在MiniKube之上,环境以及相关的软件依赖如下:
云联壹云 相关的组件运行在MiniKube之上,环境以及相关的软件依赖如下:

- 操作系统: Centos 7.6
- 最低配置要求: CPU 4核, 内存 8G, 存储 100G
Expand Down Expand Up @@ -42,13 +42,13 @@ wget https://raw.githubusercontent.com/rancher/local-path-provisioner/master/dep
kubectl apply -f local-path-storage.yaml
```

### 部署onecloud k8s operator
onecloud k8s operator地址: https://github.com/yunionio/onecloud-operator
### 部署云联壹云 k8s operator
云联壹云 k8s operator地址: https://github.com/yunionio/onecloud-operator
```bash
wget https://raw.githubusercontent.com/yunionio/onecloud-operator/master/manifests/onecloud-operator.yaml -O onecloud-operator.yaml
kubectl apply -f onecloud-operator.yaml
```
### 部署onecloud 集群
### 部署云联壹云 集群
```bash
wget https://raw.githubusercontent.com/yunionio/onecloud-operator/master/manifests/example-onecloud-cluster.yaml -O onecloud-cluster.yaml
vim onecloud-cluster.yaml
Expand All @@ -62,7 +62,7 @@ vim onecloud-cluster.yaml
```

- 其他集群配置请参考: [OnecloudClusterSpec](https://github.com/yunionio/onecloud-operator/blob/4c871ae1d3d6774a827834464c480287b7b8b433/pkg/apis/onecloud/v1alpha1/types.go#L97)::
- 启动onecloud集群
- 启动云联壹云集群
```
kubectl apply -f onecloud-cluster.yaml
```
Expand All @@ -83,7 +83,7 @@ kubectl -n onecloud port-forward `kubectl -n onecloud get pods | grep "example-
打开浏览器:https://localhost:9999

### 待解决的问题
4类Pod启动失败,问题还在分析中,但不影响体验onecloud
4类Pod启动失败,问题还在分析中,但不影响体验云联壹云

- example-onecloud-cluster-notify
- example-onecloud-cluster-host-deployer
Expand Down
2 changes: 1 addition & 1 deletion content/zh/docs/setup/_index.md
Expand Up @@ -3,5 +3,5 @@ title: "安装部署"
linkTitle: "安装部署"
weight: 1
description: >
介绍如何部署 onecloud 后端服务组件
介绍如何部署 云联壹云 后端服务组件
---

0 comments on commit e1d95c4

Please sign in to comment.