diff --git a/docs/getting-started/baremetal/docker-compose.mdx b/docs/getting-started/baremetal/docker-compose.mdx index 81fb427..3471fd9 100644 --- a/docs/getting-started/baremetal/docker-compose.mdx +++ b/docs/getting-started/baremetal/docker-compose.mdx @@ -192,7 +192,8 @@ LISTEN_INTERFACE=eth0 PUBLIC_IP=10.168.222.205 docker compose up ```bash # 所有服务放到后台运行 -$ docker compose up -d +# 下面命令假设 eth0 网卡上的 ip 地址为 10.168.222.205,具体设置请根据自己的环境设置。 +$ LISTEN_INTERFACE=eth0 PUBLIC_IP=10.168.222.205 docker compose up -d # 服务放到后台后,可以通过 logs 自命令查看输出日志 $ docker compose logs -f @@ -266,3 +267,30 @@ data # 删除服务 $ docker compose down ``` + +## 升级 + +通过 docker compose 升级很方便,只用更新 docker-compose.yml 的配置文件,然后重启服务就行。 + +### 更新 compose 配置文件 + +当上游的 [ocboot/compose/baremetal/docker-compose.yml](https://github.com/yunionio/ocboot/blob/master/compose/baremetal/docker-compose.yml) 更新了,就可以通过 curl 命令下载最新的配置文件,然后重新启动就可以了,步骤如下: + +```bash +# 注意切换到对应的 cloudpods-baremetal 目录 +$ cd cloudpods-baremetal + +# 下载配置文件 +$ curl https://raw.githubusercontent.com/yunionio/ocboot/master/compose/baremetal/docker-compose.yml -o docker-compose.yaml +``` + +### 重启 compose 服务 + +拉取最新的 docker-compose.yml 配置文件后,使用下面命令重启服务就行了。 + +```bash +$ docker compose down + +# 下面命令假设 eth0 网卡上的 ip 地址为 10.168.222.205,具体设置请根据自己的环境设置。 +$ LISTEN_INTERFACE=eth0 PUBLIC_IP=10.168.222.205 docker compose up +``` diff --git a/docs/getting-started/cmp/quickstart-docker-compose.md b/docs/getting-started/cmp/quickstart-docker-compose.md index 5cc9b5d..415f0c6 100644 --- a/docs/getting-started/cmp/quickstart-docker-compose.md +++ b/docs/getting-started/cmp/quickstart-docker-compose.md @@ -132,6 +132,37 @@ data $ docker compose down ``` +## 升级 + +通过 docker compose 升级很方便,只用更新 docker-compose.yml 的配置文件。 + +当上游的 [ocboot/compose/docker-compose.yml](https://github.com/yunionio/ocboot/blob/master/compose/docker-compose.yml) 更新了,就可以通过 git pull 命令,拉取最新的代码,然后重新启动就可以了,步骤如下: + + +### 更新 ocboot 代码 + +登录运行 docker compose 的节点,进入 ocboot 代码目录。 + +```bash +$ cd ocboot +``` + +拉取最新的代码,并 checkout 到对应的发布版本。 + +import OcbootFetchCheckout from '@site/src/components/OcbootFetchCheckout'; + + + +### 重启 compose 服务 + +拉取最新的 docker-compose.yml 配置文件后,使用下面命令重启服务就行了。 + +```bash +$ cd compose +$ docker compose down +$ docker compose up -d +``` + ## 常见问题 ### 1. docker 服务没有打开 iptables 和 bridge 导致容器网路无法创建 @@ -148,7 +179,3 @@ Cloudpods CMP 多云管理版本包含了很多服务,如果一个一个手写 ```bash $ python3 generate-compose.py > compose/docker-compose.yml ``` - -### 3. 如何升级服务? - -参考文档:[通过 docker compose 升级](../../operations/upgrading/docker-compose-upgrade) 。 diff --git a/docs/operations/upgrading/docker-compose-upgrade.md b/docs/operations/upgrading/docker-compose-upgrade.md deleted file mode 100644 index 4644007..0000000 --- a/docs/operations/upgrading/docker-compose-upgrade.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -edition: ce -sidebar_position: 2 ---- - -# 通过 docker compose 升级 - -:::tip -该方法只能升级使用 docker compose 部署的环境,如果你的环境是 ocboot 部署的,请参考以下文档升级: - -- [通过 ocboot 升级](./ocboot-upgrade) -::: - - -通过 docker compose 升级很方便,只用更新 docker-compose.yml 的配置文件。 - -当上游的 [ocboot/compose/docker-compose.yml](https://github.com/yunionio/ocboot/blob/master/compose/docker-compose.yml) 更新了,就可以通过 git pull 命令,拉取最新的代码,然后重新启动就可以了,步骤如下: - - -## 更新 ocboot 代码 - -登录运行 docker compose 的节点,进入 ocboot 代码目录。 - -```bash -$ cd ocboot -``` - -拉取最新的代码,并 checkout 到对应的发布版本。 - -import OcbootFetchCheckout from '@site/src/components/OcbootFetchCheckout'; - - - -## 重启 compose 服务 - -拉取最新的 docker-compose.yml 配置文件后,使用下面命令重启服务就行了。 - -```bash -$ cd compose -$ docker compose down -$ docker compose up -d -``` diff --git a/docs/operations/upgrading/ocboot-upgrade.mdx b/docs/operations/upgrading/ocboot-upgrade.mdx index 7f97c57..04049e0 100644 --- a/docs/operations/upgrading/ocboot-upgrade.mdx +++ b/docs/operations/upgrading/ocboot-upgrade.mdx @@ -8,9 +8,7 @@ sidebar_position: 1 介绍如何通过 ocboot 升级服务版本到指定版本。 :::tip -ocboot 只能升级通过 ocboot 部署的环境,如果你的环境是通过 docker compose 部署的,请参考以下文档升级: - -- [通过 docker compose 升级](./docker-compose-upgrade) +ocboot 只能升级通过 ocboot 部署的环境,如果你的环境是通过 docker compose 或者 helm 部署的,请参考对应部署文档里面的升级操作。 ::: ## 前提条件 @@ -26,7 +24,7 @@ ocboot 只能升级通过 ocboot 部署的环境,如果你的环境是通过 d import ReleaseVersion from '@site/src/components/ReleaseVersion' -1. 使用 git 拉取最新的 [ocboot](https://github.com/yunionio/ocboot) 代码,切换到 的 tag +1. 下载 [ocboot](https://github.com/yunionio/ocboot/releases) 对应版本代码 2. 使用 [ocboot](https://github.com/yunionio/ocboot) 里面的 `./ocboot.sh upgrade` 命令进行版本升级 ## 查看当前版本 @@ -37,21 +35,15 @@ import GetClusterVersion from '@site/src/components/GetClusterVersion' -## 拉取 ocboot 工具 - -如果本地已经有 ocboot 工具可以跳过此步,只用把代码更新到对应的分支。 - -下载 ocboot 工具到本地: - -import OcbootClone from '@site/src/components/OcbootK3sClone'; +## 下载 ocboot 工具 - - -## 更新 ocboot 代码 +:::tip +如果本地已经有都应版本的代码,可以跳过下面的步骤,但一般情况下,随着每次新版本发布,都会有对应的 ocboot 部署工具发布,需要使用对应的版本来更新。 +::: -import OcbootFetchCheckout from '@site/src/components/OcbootK3sFetchCheckout'; +import OcbootReleaseDownload from '../../getting-started/_parts/_quickstart-ocboot-release-download.mdx'; - + ## 升级服务组件 diff --git a/src/components/OcbootFetchCheckout.js b/src/components/OcbootFetchCheckout.js index 59fe8ed..cec287c 100644 --- a/src/components/OcbootFetchCheckout.js +++ b/src/components/OcbootFetchCheckout.js @@ -2,11 +2,11 @@ import CodeBlock from '@theme/CodeBlock'; import { getCustomField } from './utils'; export default function OcbootFetchCheckout() { - const version = getCustomField('release_version') + const branch = getCustomField('release_branch') return ( { - `$ git fetch\n` + `$ git checkout ${version}` + `$ git fetch --all\n` + `$ git checkout origin/${branch}` } )