专栏首页TLingC's Zone使用Coding企业版自动部署mkdocs文档

使用Coding企业版自动部署mkdocs文档

整体思路

mkdocs自身放在master分支,master分支有修改时调用持续集成,进行构建并把构建后的文件推送回gh-pages分支,再触发持续部署中的静态网站功能,把文档上线。

实现步骤

  1. 进入仓库,设置->开发者选项->项目令牌,新建一个用户后面部署的令牌,记得勾选读写权限。完成后,记下用户名和密码。
  1. 新增一个持续集成,用于对文档进行构建和部署。

Jenkinsfile如下: 我的项目用到额外的mkdocs-material、mkdocs-minify-plugin组件,如果不需要可删除(构建步骤里)

pipeline {
    agent {
        label 'python-3.5'
    }
    stages {
        stage('检出') {
            steps {
                checkout([$class: 'GitSCM', branches: [[name: env.GIT_BUILD_REF]], 
                          userRemoteConfigs: [[url: env.GIT_REPO_URL, credentialsId: env.CREDENTIALS_ID]]])
            }
        }
        stage('构建') {
            steps {
                sh 'pip install mkdocs mkdocs-material mkdocs-minify-plugin' 
            }
        }
        stage('部署') {
            steps {
                sh 'echo -e "machine e.coding.net login ${GIT_USERNAME} password ${GIT_PASSWORD}" > ~/.netrc'
                sh 'git remote set-url origin ${GIT_PUSHURL}'
                sh 'mkdocs gh-deploy -v --force --clean'
            }
        }
    }
}

同时配置好环境变量,GIT_USERNAME和GIT_PASSWORD即第一步获得的用户名和密码,GIT_PUSHURL是仓库地址。

3. 进入持续部署->静态网站,新建。

4. 完成。推送代码到master分支或者手动触发即可开始部署。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Github Pages新的自定义域名HTTPS功能无法打开的解决方案

    博客此前一直在用Cloudflare提供的HTTPS功能,但是挂了Cloudflare后Ping一直都在150ms+,而且还经常受干扰不稳定,而Github P...

    TLingC
  • 使用Jenkins持续集成部署QQ小程序

    QQ小程序提供了Docker镜像来对小程序项目进行CI构建(文档)。文档中提供的Github Actions及Drone CI两种CI工具都对Docker的相关...

    TLingC
  • Coding企业版部署mkdocs文档出现404解决方法

    根据我的上一篇文章“使用Coding企业版自动部署mkdocs文档 ”来进行部署mkdocs文档,最近出现了404问题。查看部署记录没有异样。

    TLingC
  • Git 码云操作

    二十三年蝉
  • git中出现的一些问题 原

    晓歌
  • VIO你用对了吗

    既然是Virtual(虚拟的),就表明这个输入或输出并不是真实存在于FPGA设计中。下图显示了VIO的输入、输出管脚。其中,输入、输出管脚最大可支持到256位。...

    Lauren的FPGA
  • 移动端开发框架Zepto.js入门(快速方式,后端node开发)

    晓歌
  • win10 uwp 车表盘 径向规

    这个库是大神做的,要使用大神做的库是很简单。在安装完成了 nuget 就可以在我们需要的项目引用xmlns:controls="using:WinRTXamlT...

    林德熙
  • SSH远程连接服务器

    2.点击图中加号输入目的IP然后在箭头2的方框中输入ssh username@IP:

    OvO我是肉排菌呀
  • Mybatis之工作原理

    mybatis底层还是采用原生jdbc来对数据库进行操作的,只是通过 SqlSessionFactory,SqlSession Executor,Stateme...

    Java编程指南

扫码关注云+社区

领取腾讯云代金券