Skip to content
This repository has been archived by the owner on Feb 18, 2024. It is now read-only.

Commit

Permalink
update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
LiuYu committed Nov 8, 2023
1 parent 24bd077 commit 8ef3ef7
Show file tree
Hide file tree
Showing 12 changed files with 18 additions and 23 deletions.
4 changes: 4 additions & 0 deletions docs/content/zh-cn/docs/quick-start/_index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -38,3 +38,7 @@ kubectl apply -f config/samples/module-deployment_v1alpha1_moduledeployment_prov

<br/>
<br/>

# 欢迎大家学习 SOFAServerless 视频教程

[点击此处](/docs/tutorials/video-training)查看 SOFAServerless 平台与研发框架视频培训教程。
6 changes: 3 additions & 3 deletions docs/content/zh-cn/docs/tutorials/video–training.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ title: 视频教程
weight: 1
---

SOFAServerless 平台与研发框架视频培训课程重磅发布！
## SOFAServerless 平台与研发框架视频培训课程重磅发布

步骤 1：[点击链接](https://beta.oscollege.net/product?invite=true&key=1662838629963194399&sign=UtWAPq5uAiBuf6uqe7LWXOTdh0a8cyvo58Ft6z9TP4O4vqyRDnfgTSjPz3cpz2JM7yC1qdgQ%2BltrZP1pNtqqB4c%2FOrSkP6GD6o0qHbI4GzErPZGTHNES2VlbiGOPzF2NRzkKE1BxLmFwfQWSF844Qb7JoNlA24t24cm6ic%2Fuv1gq4L2XYq3hxVJ7xXL1QZcG7yfJTDBGsiNdrmqBNEMpyTwNcIdPko8RoB%2B1uQbEDYUDt5xOmQnUAOuJTNxSVU3sSVTukSpLNENM7deKUaTtoLJJ%2BH4bbgrkgsufGiD1KJ7c6LSSlnkH9Vd630O6TG8s13Z%2FwFp%2FuWnxUlA2YArgjA%3D%3D)注册开源学堂账号。
步骤 1：[点击此处](https://beta.oscollege.net/product?invite=true&key=1662838629963194399&sign=UtWAPq5uAiBuf6uqe7LWXOTdh0a8cyvo58Ft6z9TP4O4vqyRDnfgTSjPz3cpz2JM7yC1qdgQ%2BltrZP1pNtqqB4c%2FOrSkP6GD6o0qHbI4GzErPZGTHNES2VlbiGOPzF2NRzkKE1BxLmFwfQWSF844Qb7JoNlA24t24cm6ic%2Fuv1gq4L2XYq3hxVJ7xXL1QZcG7yfJTDBGsiNdrmqBNEMpyTwNcIdPko8RoB%2B1uQbEDYUDt5xOmQnUAOuJTNxSVU3sSVTukSpLNENM7deKUaTtoLJJ%2BH4bbgrkgsufGiD1KJ7c6LSSlnkH9Vd630O6TG8s13Z%2FwFp%2FuWnxUlA2YArgjA%3D%3D)注册开源学堂账号。

步骤 2：在开源学堂首页点击上方 “学习” 选项卡，然后点击进入 “SOFAServerless 研发框架与产品介绍”，点击 “开始学习”。
步骤 2：在开源学堂首页点击上方 **“学习”** 选项卡，然后点击进入 **“SOFAServerless 研发框架与产品介绍”**，点击 **“开始学习”**。
3 changes: 0 additions & 3 deletions docs/content/zh-cn/home/_index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -40,9 +40,6 @@ url: "/home/"
<a href="/docs/quick-start/" style="display: inline-block; width: 176px; margin-right: 12px;">
<img style="margin: 0;" src="/img/local-quick-start-btn.png" width="176px" />
</a>
<a href="https://beta.oscollege.net/product?invite=true&key=1662838629963194399&sign=UtWAPq5uAiBuf6uqe7LWXOTdh0a8cyvo58Ft6z9TP4O4vqyRDnfgTSjPz3cpz2JM7yC1qdgQ%2BltrZP1pNtqqB4c%2FOrSkP6GD6o0qHbI4GzErPZGTHNES2VlbiGOPzF2NRzkKE1BxLmFwfQWSF844Qb7JoNlA24t24cm6ic%2Fuv1gq4L2XYq3hxVJ7xXL1QZcG7yfJTDBGsiNdrmqBNEMpyTwNcIdPko8RoB%2B1uQbEDYUDt5xOmQnUAOuJTNxSVU3sSVTukSpLNENM7deKUaTtoLJJ%2BH4bbgrkgsufGiD1KJ7c6LSSlnkH9Vd630O6TG8s13Z%2FwFp%2FuWnxUlA2YArgjA%3D%3D" style="display: inline-block; width: 176px; margin-right: 12px;">
<img style="margin: 0;" src="/img/local-quick-start-btn.png" width="176px" />
</a>
<a href="/docs/introduction/intro-and-scenario" style="display: inline-block; width: 176px;">
<img style="margin: 0;" src="/img/more-details-btn.png" width="176px" />
</a>
Expand Down
1 change: 0 additions & 1 deletion docs/public/_print/home/index.html
View file

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion docs/public/docs/_print/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
</span></span><span style=display:flex><span><span style=color:#8f5902;font-style:italic># 忽略未解析的占位符</span>
</span></span><span style=display:flex><span><span style=color:#c4a000>com.alipay.sofa.ignore.unresolvable.placeholders</span><span style=color:#ce5c00;font-weight:700>=</span><span style=color:#4e9a06>true</span>
</span></span></code></pre></div><h3 id=开启方式>开启方式</h3><p>模块打包插件里增加如下配置：<br><img src="https://intranetproxy.alipay.com/skylark/lark/0/2022/png/149473/1668428226653-d1ad571e-a580-42fa-9ca0-ff63c199dfb1.png#clientId=u664f9b10-526b-4&amp;from=paste&amp;height=399&amp;id=uf9e74e96&amp;originHeight=798&amp;originWidth=975&amp;originalType=binary&amp;ratio=1&amp;rotation=0&amp;showTitle=false&amp;size=116831&amp;status=done&amp;style=none&amp;taskId=u2287fc36-ca94-4018-94f5-5a33dcb87b2&amp;title=&amp;width=487.5" alt=image.png></p><h3 id=开启后的副作用>开启后的副作用</h3><p>如果模块委托给基座的依赖里有发布服务，那么基座和模块会同时发布两份。</p><br></div><div class=td-content style=page-break-before:always><h1 id=pg-6546478d87b4368b79e83eb0e32c466c>2 - 快速开始</h1><h1 id=实验-1一键实现多应用合并部署>实验 1：一键实现多应用合并部署</h1><p>合并部署是指：选定一个应用作为底座，然后将多个其它应用合并部署到这个底座之上，从而实现长尾应用的极致资源降本。典型业务场景为应用的低成本交付 以及 微服务过度拆分一键重新合并。</p><ol><li>选定一个应用作为底座（SOFAServerless 术语叫<strong>基座</strong>），将普通应用<a href=/docs/tutorials/base-create/springboot-and-sofaboot/>一键升级为基座</a>。</li><li>选定一个应用作为上层应用（SOFAServerless 术语叫<strong>模块</strong>），将其<a href=/docs/tutorials/module-create/springboot-and-sofaboot/>一键转为模块应用并完成合并部署</a>。<br>您也可以直接使用 <a href=https://github.com/sofastack/sofa-serverless/tree/master/samples/springboot-samples/service>官方 Demo 和文档</a> 在本地完成实验。</li></ol><p>小贴士：无论<strong>基座</strong>还是<strong>模块</strong>，接入 SOFAServerless 后，同一套代码分支既能像原来一样独立启动，又能做到合并部署。</p><br><br><h1 id=实验-2一键体验应用秒级热部署>实验 2：一键体验应用秒级热部署</h1><h2 id=步骤-1本地软件安装>步骤 1：本地软件安装</h2><p>下载安装 <strong>go</strong>（建议 1.20 或以上）、<strong>docker</strong>、<strong>minikube</strong>、<strong>kubectl</strong>。</p><h2 id=步骤-2一键启动-sofaserverless>步骤 2：一键启动 SOFAServerless</h2><p>使用 <strong>git</strong> 拉取 GitHub sofa-severless 项目：<a href=https://github.com/sofastack/sofa-serverless>https://github.com/sofastack/sofa-serverless</a><br>在 <strong>module-controller</strong> 目录下执行 <strong>make dev</strong> 命令一键部署环境，会自动执行 minikube service 命令弹出网页，由于此时您还没有发布模块，所以网页不会有任何内容显示。</p><h2 id=步骤-3秒级发布模块>步骤 3：秒级发布模块</h2><p>执行以下命令：</p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-bash data-lang=bash><span style=display:flex><span>kubectl apply -f config/samples/module-deployment_v1alpha1_moduledeployment_provider.yaml
</span></span></code></pre></div><p>即可秒级发布上线模块应用。请等待本地 Module CR 资源 Status 字段值变更为 Available**（约 1 秒，表示模块发布完毕）**，再刷新步骤 2 自动打开的网页，即可看到一个简单的卖书页面，这个卖书逻辑就是在模块里实现的：<br><img src="https://intranetproxy.alipay.com/skylark/lark/0/2023/png/671/1694161452232-15aec134-3b2a-491f-9295-0c5f8f7341af.png#clientId=ue383ca9b-aa63-4&amp;from=paste&amp;height=443&amp;id=ub3eb7eb8&amp;originHeight=1318&amp;originWidth=1626&amp;originalType=binary&amp;ratio=2&amp;rotation=0&amp;showTitle=false&amp;size=168110&amp;status=done&amp;style=none&amp;taskId=u07f60163-67e4-42fa-bc41-76e43a09c1f&amp;title=&amp;width=546" alt=image.png></p><h2 id=步骤-4清理本地环境>步骤 4：清理本地环境</h2><p>您可以使用 <strong>make undev</strong> 删除所有本地资源，清理本地环境。</p><br><br></div><div class=td-content style=page-break-before:always><h1 id=pg-68ec2370d0409cc27325be36693f9368>3 - 用户手册</h1></div><div class=td-content><h1 id=pg-b3935c05c25081c99965e840a2880604>3.1 - 视频教程</h1><p>SOFAServerless 平台与研发框架视频培训课程重磅发布！</p><p>步骤 1：<a href="https://beta.oscollege.net/product?invite=true&amp;key=1662838629963194399&amp;sign=UtWAPq5uAiBuf6uqe7LWXOTdh0a8cyvo58Ft6z9TP4O4vqyRDnfgTSjPz3cpz2JM7yC1qdgQ%2BltrZP1pNtqqB4c%2FOrSkP6GD6o0qHbI4GzErPZGTHNES2VlbiGOPzF2NRzkKE1BxLmFwfQWSF844Qb7JoNlA24t24cm6ic%2Fuv1gq4L2XYq3hxVJ7xXL1QZcG7yfJTDBGsiNdrmqBNEMpyTwNcIdPko8RoB%2B1uQbEDYUDt5xOmQnUAOuJTNxSVU3sSVTukSpLNENM7deKUaTtoLJJ%2BH4bbgrkgsufGiD1KJ7c6LSSlnkH9Vd630O6TG8s13Z%2FwFp%2FuWnxUlA2YArgjA%3D%3D">点击链接</a>注册开源学堂账号。</p><p>步骤 2：在开源学堂首页点击上方 “学习” 选项卡，然后点击进入 “SOFAServerless 研发框架与产品介绍”，点击 “开始学习”。</p></div><div class=td-content style=page-break-before:always><h1 id=pg-85d651fc55ba7dc800d677008a2c7fa5>3.2 - 基座接入</h1></div><div class=td-content><h1 id=pg-18b872e057bed8156d471e220e894432>3.2.1 - SpringBoot 或 SOFABoot 升级为基座</h1><h2 id=前提条件>前提条件</h2><ol><li>SpringBoot 版本 >= 2.3.0（针对 SpringBoot 用户）</li><li>SOFABoot 版本 >= 3.9.0 或 SOFABoot >= 4.0.0（针对 SOFABoot 用户）</li></ol><h2 id=接入步骤>接入步骤</h2><h3 id=代码与配置修改>代码与配置修改</h3><h4 id=修改-applicationproperties>修改 application.properties</h4><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-properties data-lang=properties><span style=display:flex><span><span style=color:#8f5902;font-style:italic># 需要定义应用名</span>
</span></span></code></pre></div><p>即可秒级发布上线模块应用。请等待本地 Module CR 资源 Status 字段值变更为 Available**（约 1 秒，表示模块发布完毕）**，再刷新步骤 2 自动打开的网页，即可看到一个简单的卖书页面，这个卖书逻辑就是在模块里实现的：<br><img src="https://intranetproxy.alipay.com/skylark/lark/0/2023/png/671/1694161452232-15aec134-3b2a-491f-9295-0c5f8f7341af.png#clientId=ue383ca9b-aa63-4&amp;from=paste&amp;height=443&amp;id=ub3eb7eb8&amp;originHeight=1318&amp;originWidth=1626&amp;originalType=binary&amp;ratio=2&amp;rotation=0&amp;showTitle=false&amp;size=168110&amp;status=done&amp;style=none&amp;taskId=u07f60163-67e4-42fa-bc41-76e43a09c1f&amp;title=&amp;width=546" alt=image.png></p><h2 id=步骤-4清理本地环境>步骤 4：清理本地环境</h2><p>您可以使用 <strong>make undev</strong> 删除所有本地资源，清理本地环境。</p><br><br><h1 id=欢迎大家学习-sofaserverless-视频教程>欢迎大家学习 SOFAServerless 视频教程</h1><p><a href=/docs/tutorials/video-training>点击此处</a>查看 SOFAServerless 平台与研发框架视频培训教程。</p></div><div class=td-content style=page-break-before:always><h1 id=pg-68ec2370d0409cc27325be36693f9368>3 - 用户手册</h1></div><div class=td-content><h1 id=pg-b3935c05c25081c99965e840a2880604>3.1 - 视频教程</h1><h2 id=sofaserverless-平台与研发框架视频培训课程重磅发布>SOFAServerless 平台与研发框架视频培训课程重磅发布</h2><p>步骤 1：<a href="https://beta.oscollege.net/product?invite=true&amp;key=1662838629963194399&amp;sign=UtWAPq5uAiBuf6uqe7LWXOTdh0a8cyvo58Ft6z9TP4O4vqyRDnfgTSjPz3cpz2JM7yC1qdgQ%2BltrZP1pNtqqB4c%2FOrSkP6GD6o0qHbI4GzErPZGTHNES2VlbiGOPzF2NRzkKE1BxLmFwfQWSF844Qb7JoNlA24t24cm6ic%2Fuv1gq4L2XYq3hxVJ7xXL1QZcG7yfJTDBGsiNdrmqBNEMpyTwNcIdPko8RoB%2B1uQbEDYUDt5xOmQnUAOuJTNxSVU3sSVTukSpLNENM7deKUaTtoLJJ%2BH4bbgrkgsufGiD1KJ7c6LSSlnkH9Vd630O6TG8s13Z%2FwFp%2FuWnxUlA2YArgjA%3D%3D">点击此处</a>注册开源学堂账号。</p><p>步骤 2：在开源学堂首页点击上方 <strong>“学习”</strong> 选项卡，然后点击进入 <strong>“SOFAServerless 研发框架与产品介绍”</strong>，点击 <strong>“开始学习”</strong>。</p></div><div class=td-content style=page-break-before:always><h1 id=pg-85d651fc55ba7dc800d677008a2c7fa5>3.2 - 基座接入</h1></div><div class=td-content><h1 id=pg-18b872e057bed8156d471e220e894432>3.2.1 - SpringBoot 或 SOFABoot 升级为基座</h1><h2 id=前提条件>前提条件</h2><ol><li>SpringBoot 版本 >= 2.3.0（针对 SpringBoot 用户）</li><li>SOFABoot 版本 >= 3.9.0 或 SOFABoot >= 4.0.0（针对 SOFABoot 用户）</li></ol><h2 id=接入步骤>接入步骤</h2><h3 id=代码与配置修改>代码与配置修改</h3><h4 id=修改-applicationproperties>修改 application.properties</h4><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-properties data-lang=properties><span style=display:flex><span><span style=color:#8f5902;font-style:italic># 需要定义应用名</span>
</span></span><span style=display:flex><span><span style=color:#c4a000>spring.application.name</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#4e9a06>${替换为实际基座应用名}</span>
</span></span></code></pre></div><h4 id=修改主-pomxml>修改主 pom.xml</h4><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-xml data-lang=xml><span style=display:flex><span><span style=color:#204a87;font-weight:700>&lt;properties&gt;</span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>&lt;sofa.ark.verion&gt;</span>2.2.4-SNAPSHOT<span style=color:#204a87;font-weight:700>&lt;/sofa.ark.verion&gt;</span>
Expand Down
Loading

0 comments on commit 8ef3ef7

Please sign in to comment.