部署篇:如何将demo部署到Github以及绑定域名
本篇将介绍如何将静态页面部署托管到Github,然后我们可以外网在线随意访问,同样国内也有类似Github这种代码仓库托管平台,比如Gitee码云、Coding。Github是世界程序员的平台,用户和资源都是最多的,所以,文章下边主要是针对Github来讲解介绍。
首先举例几个让大家看效果,以下都是前端静态页面网页,无后端,都是托管于 Github:
(资料图)
·个人主页: html页面
·博客: 使用Hexo博客框架构建的静态页面博客
·个人Demo/项目集合 (样式不兼容手机)
·NgxFromBuilder 表单自动化构建 Angular开发,打包后部署Github
·个人旅游地图相册 和前面章节介绍到的Leaflet实现旅游相册类似,部署到Github后绑定域名而已
·mapshaper-plus 基于mapshaper实现的,扩展Echarts地图数据转换
·在线简历 使用实现的效果
……
链接地址:gis616(添加备注链接)
不管是项目、demo、工具集合,只要你是纯前端静态资源的东西都可以部署到 Github 。本章主要目的就是给大家介绍如何部署demo到Github,就用我们前面几章节中的demo来介绍部署过程。(继续往下看,你要先有Github网站账号)
前期准备
先了解 Github Pages
正如官方首页 Github Pages 介绍一样,Github Pages 是用来方便的发布你工程的网站,官方介绍了Git命令式的方式提交代码。没使用过git的同学可能看不懂,下边我将介绍使用可视化界面操作来介绍。
工具软件
需要安装以下两个软件,到官网下载对于电脑环境的安装包,直接安装就行。
·Git 代码版本管理工具(类似SVN,比SVN强大好用)
·TortoiseGit Git命令可视化GUI工具
Github托管Demo
(1)登录github新建工程
新建工程
填写工程名称(自己随意填写,一般按工程含义填写即可,这里我是演示用,随意取的名称),其他相关信息非必填。
工程信息填写
(2)提交代码到工程
复制工程项目git地址,提交代码到git工程,如果了解git的同学可以用 git clone 项目地址的方式克隆下来。
git clone
首次使用的同学,通过上边安装的 TortoiseGit 软件来下载项目代码。
(windows)桌面右键,弹出菜单选择 git clone ,输入工程git地址
然后将你的代码,复制到克隆下来的工程目录下,这里我们介绍master复制搭建静态页面的话,就直接放到工程根目录即可。比如我们将之前第5章中,介绍的openlayers、leaflet、arcgis 三个不同JS库实现地图加载的Demo代码拷贝到工程中。因为静态页面部署,web服务器默认找的是文件,所以我们复制leafletdemo/ 文件到工程根目录下。(如果你部署的是自己的demo,这里只需要将demo下的文件拷贝到工程目录即可)
最后提交代码,工程根目录文件夹下,右键菜单选择git commit->master,输入提交信息,勾选需要提交的文件,然后点击提交,最后还要点击push,推送到远程工程。
提交代码
提交推送
账号确认
启用 Gtihub Pages
提交代码成功后,我们打开Github对于的工程主页,如果,选择设置:
设置入口
设置Github Pages为master分支
保存设置后,Github Pages会自动生成一个二级域名+工程名称的访问地址。生成规则是:https://用户名./工程名称,现在演示的demo部署地址就为 /demo_test/
我们就可以通过地址访问我们的demo了。到此就部署成功。
demo地址预览
因为以上我复制了三个demo的代码到工程目录下提交的,所以其他demo的效果也可以访问到:
·arcgisdemo: /demo_test/arcgisdemo/
·openlayersdemo: /demo_test/openlayersdemo/
以上我们演示的是master分支部署托管静态页面,其他还可以支持gh-pages 分支,master目录下的doc文件夹部署。感兴趣的同学可以多了解一下。
绑定域名绑定域名的前提需要注册域名,注册域名的网站很多,比如阿里云、百度云、腾讯云、万网(也是阿里的)、西部数码等。
下边介绍截图是阿里购买的域名绑定github pages,其他平台都是类似的。
(1)域名解析
到域名管理列表中,找到自己需要绑定的域名,选择域名解析
第一步:
域名解析
第二步:
添加解析纪录
第三步:
A纪录绑定
第三步中,选择A纪录绑定,绑定的是自己github二级域名的ip地址,该ip可以通过CMD里输入ping 用户名.的方式知道ip地址多少。
绑定后:
解析纪录详情
(2)工程创建CNAME文件,绑定解析的二级域名
在你的github工程根目录下(以上举例则为demo_test/CNAME),新建一个名为CNAME文件,右键文本编辑器打开,输入你想要绑定的域名(对应你域名解析的域名即可)直接输入即可。然后提交,见提交日记
最后通过域名 即可访问上边的demo了。如果你想一个域名针对一个demo,去掉二级域名的话,那就是 的效果,这种情况也是类似的,域名解析好,CNAME绑定就可以了。文章一开始介绍的demo都是部署托管Github的,不管是一级域名还是二级域名,还是demo路径的方式,都可以做到的。
其他介绍
发布到Github Pages的过程,其实可以搞成自动化的方式,代码打包后,通过git提交到对于gh-pages分支,这块熟悉了git和github的同学可以尝试一下。
其他的如Hexo博客框架,本质上是通过编译 Markdown 文件为html静态文件,然后部署到Github Pages,也就成了静态博客的效果了。早期个人的博客就是这么搞的。
本章小结
本章主要介绍如果将demo静态文件部署到Github,并介绍了自定义域名绑定demo。利用好Github Pages,可以自己做网页效果,也可以直接生成工程使用介绍页面,Github上很多开源的
库、框架,都是生成文档,然后直接通过Github Pages去发布API文档,或者网站介绍。只是绑定了自定义域名而已。因为这就是Github提供Github Pages的主要目的。如果文章中有错误的地方欢迎指出,也欢迎留言讨论。
本文链接地址:gis616(备注链接,免费获取)
(持续更新中....)
关键词: