一键部署Yaydoc到Heroku：零代码实现文档自动化平台

【免费下载链接】yaydocDocs! Yay!项目地址: https://gitcode.com/gh_mirrors/ya/yaydoc

Yaydoc是一款强大的文档自动化平台，能帮助开发者轻松实现文档的自动生成与部署。本文将详细介绍如何通过零代码的方式，一键将Yaydoc部署到Heroku平台，让你快速拥有属于自己的文档自动化系统。

Heroku平台简介

Heroku是一种云平台即服务（PaaS），被广泛用作Web应用程序的部署模型。Yaydoc的Web用户界面是一个NodeJS应用，而Heroku为在云中部署和扩展Node.js应用程序提供了极大的便利。

零代码部署：一键搞定Yaydoc

简单到难以置信的部署方式

Yaydoc提供了极为便捷的一键Heroku部署功能，无需编写任何代码，只需点击下方按钮即可开始部署流程。

准备工作

在进行部署之前，你需要确保拥有Heroku账号。如果还没有，可以先访问Heroku官网注册一个免费账号。

开始一键部署

点击下面的部署按钮，系统将自动引导你完成Yaydoc在Heroku上的部署过程。

手动部署步骤（可选）

虽然一键部署已经非常方便，但了解手动部署过程也有助于你更好地理解Yaydoc在Heroku上的运行机制。

安装Heroku CLI

如果你使用的是基于Linux的操作系统，可以在终端中输入以下命令安装Heroku CLI：

wget -qO- https://cli-assets.heroku.com/install-ubuntu.sh | sh

对于其他操作系统，可以参考Heroku官方文档的安装说明。

登录Heroku服务器

在终端中输入以下命令，然后输入你的Heroku账号凭据进行登录：

heroku login

部署Yaydoc到Heroku

首先，克隆Yaydoc仓库到本地：

git clone https://gitcode.com/gh_mirrors/ya/yaydoc cd yaydoc/

然后创建一个Heroku应用：

heroku create

接下来添加必要的buildpacks：

heroku buildpacks:set heroku/nodejs heroku buildpacks:add --index 2 heroku/python heroku buildpacks:add --index 3 https://github.com/imujjwal96/heroku-buildpack-pandoc.git heroku buildpacks:add --index 4 https://github.com/heroku/heroku-buildpack-cli heroku buildpacks:add --index 5 https://github.com/heroku/heroku-buildpack-jvm-common

设置环境变量：

heroku config:set DEPLOYMENT=true heroku config:set ENCRYPTION_KEY=AVERYSECRETTOKENOFTHIRTYTWOCHARACTERS heroku config:set GITHUB_CALLBACK_URL=https:// .herokuapp.com/auth/github/callback heroku config:set GITHUB_CLIENT_ID= heroku config:set GITHUB_CLIENT_SECRET= heroku config:set HEROKU_CALLBACK_URL=https:// .herokuapp.com/auth/heroku/callback heroku config:set HEROKU_CLIENT_ID= heroku config:set HEROKU_CLIENT_SECRET= heroku config:set HOSTNAME= .herokuapp.com heroku config:set MONGODB_URI=mongodb:// : @ds151662.mlab.com:51662/ heroku config:set PYPANDOC_PANDOC=~/vendor/pandoc/bin/pandoc heroku config:set SECRET= heroku config:set SMTP_USERNAME= heroku config:set SMTP_PASSWORD= heroku config:set SMTP_HOST= heroku config:set SMTP_PORT=

最后部署代码：

git push heroku master

打开应用：

heroku open

你的应用将在 https://your-app-name.herokuapp.com/ 上可用。

设置从GitHub仓库自动部署

有时，我们希望每次有新的PR合并或提交推送到仓库时，自动更新我们的Web应用。Heroku提供了这样的工具！

登录Heroku网站

访问Heroku网站并使用你的凭据登录。登录后，从可用列表中选择yaydoc项目。进入项目页面后，导航到"部署"选项卡。

连接到GitHub

将部署方法从Heroku Git选项更改为GitHub。会弹出一个窗口，要求对您的GitHub账户进行OAuth授权，您必须批准。

设置自动部署并部署应用！

成功将GitHub账户链接到Heroku后，在下方搜索要连接的仓库。你应该选择Yaydoc仓库的分支。

选择主分支或开发分支，并启用"等待CI通过后再部署"选项。现在你可以选择"自动部署"，设置就成功完成了。

你的应用将随着仓库的每次更新自动更新，地址为：https://your-app-name.herokuapp.com/

总结

通过本文介绍的方法，无论是一键部署还是手动部署，你都可以轻松地在Heroku上搭建起Yaydoc文档自动化平台。Yaydoc将帮助你实现文档的自动生成与部署，极大地提高开发效率。如果你想深入了解Yaydoc的配置选项，可以参考官方文档 docs/installation/heroku.md。

希望本文对你有所帮助，祝你的文档自动化之旅顺利！🚀

【免费下载链接】yaydocDocs! Yay!项目地址: https://gitcode.com/gh_mirrors/ya/yaydoc