云端golang开发,无需本地配置,能上网就能开发和运行 ...

没腿的鸟  金牌会员 | 2023-11-21 04:17:06 | 来自手机 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题

主题 883|帖子 883|积分 2649

欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码):https://github.com/zq2599/blog_demos
需求


  • 学习golang的时候,需要一个IDE,还需要一个能运行程序的环境,以及一个MySQL数据库
  • 对于有经验的程序员来说,自己动手安装部署即可,但是小白和懒人也是存在的...
背景


  • 背景很简单:欣宸个人情况如下

  • 穷:有个能上网的破电脑,甚至电脑都没有,仅有个安卓平板(万幸的是有键盘鼠标,打字没问题)
  • 懒:不想安装golang,也不想安装vscode(如果只有安卓平板,就是想装也没办法装)


  • 面对这样无可救药的自己,内心还是想拯救一下,于是有了这篇文章,基于GitHub的Codespaces 快速搭建一套云端开发环境,让穷、懒不再拖累我学习的热情...
前提


  • 用破电脑凭空打造golang开发环境,需要以下两个前提条件

  • 能上网,因为要访问GitHub
  • 有个属于自己的GitHub账号


  • 准备好以上条件就开始吧
打造环境


  • 首先登录GitHub
  • 其次准备好一个代码仓库,已有的或现在就新建都可以,我这里用的是旧仓库,里面保存了多年的博客中用到的源码,是个超级大杂烩,有java工程的,也有golang的,还有一些ansible脚本,如下所示,不过没事儿,不影响,都能用

  • 然后按照下图的数字顺序进行操作,进入云端开发环境的设置页面

  • 然后按照下图操作,选择配置模板

  • 按照下图操作,获取到配置模板,然后粘贴到自己项目的配置区域,再提交保存,这样就完成了自己的golang云开发环境配置

  • 注意上面的内容,共有两个配置项

  • 部署了go1.18版本,您可以根据自己的需要修改,我这改成了1.19
  • 安装了docker(配置里叫docker-in-docker,因为咱们的云开发环境就是个docker容器,官方文档中有说明)


  • 然后回到仓库主页面,按照如下操作,即可创建一个云开发环境,用的是前面的配置

  • 然后需要等待几分钟,GitHub会根据您的配置创建新的云开发环境
  • 稍作等待就会跳转到web版本的vscode页面,如下图(安卓平板电脑浏览器截图),资源管理器的内容就是您的GitHub仓库的内容,由于我的仓库中有很多java旧代码,被vscode识别到之后会提示安装JDK,请无视掉这些提示,因为它们都和本篇无关

  • 如下图,在控制台查看golang和docker的版本,都符合预期,微软真是给力,web版IDE和服务器都白送

  • 用top命令查看资源情况,发现是2核4G的服务器资源

  • 其实微软还算慷慨,免费资源最多给到了4核8G,咱们回到仓库页面去调整一下,如下图

  • 如下图修改配置,并使其立即生效

  • 至此,环境准备好了,咱们来写代码验证一下
设置GO111MODULE


  • 记得用go env看一下GO111MODULE环境变量的设置,因为接下来的项目是基于go mod进行管理的,所以要打开这个设置,最好是执行以下命令,使其生效
  1. go env -w GO111MODULE=on
复制代码
验证之一:helloworld


  • 接下来咱们基于gin新建一个web服务,试试这个开发环境能否正常使用
  • 在web版的vscode上,找个干净目录,例如我这边新建名为test003的文件夹
  • 用go mod命令新建module
  1. go mod init test003
复制代码

  • 下载和安装gin
  1. go get -u github.com/gin-gonic/gin
复制代码

  • 新建main.go文件,内容如下
  1. package main
  2. import "github.com/gin-gonic/gin"
  3. func main() {
  4.         router := gin.Default()
  5.         router.GET("/", func(c *gin.Context) {
  6.                 c.JSON(200, gin.H{
  7.                         "message": "hello world",
  8.                 })
  9.         })
  10.         router.Run()
  11. }
复制代码

  • 执行go mod tidy解决依赖
  • 最后执行go run main.go将服务运行起来
  1. @zq2599 ➜ /workspaces/blog_demos/tutorials/test003 (dev) $ go run main.go
  2. [GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.
  3. [GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
  4. - using env:   export GIN_MODE=release
  5. - using code:  gin.SetMode(gin.ReleaseMode)
  6. [GIN-debug] GET    /                         --> main.main.func1 (3 handlers)
  7. [GIN-debug] [WARNING] You trusted all proxies, this is NOT safe. We recommend you to set a value.
  8. Please check https://pkg.go.dev/github.com/gin-gonic/gin#readme-don-t-trust-all-proxies for details.
  9. [GIN-debug] Environment variable PORT is undefined. Using port :8080 by default
  10. [GIN-debug] Listening and serving HTTP on :8080
  11. [GIN] 2023/02/04 - 14:10:22 | 200 |        58.7µs | 220.246.254.226 | GET      "/"
  12. [GIN] 2023/02/04 - 14:10:22 | 404 |         900ns | 220.246.254.226 | GET      "/favicon.ico"
复制代码

  • 再去看端口这个Tab页,如下图,发现gin监听的8080端口已经被forward到一个公网地址,点击红色箭头的图标,用浏览器访问这个地址

  • 能够收到body响应,证明刚才的代码已经生效了,至此云端的IDE和运行环境都验证通过

  • 至此,云端开发运行基本的web应用没问题了,咱们再试试数据库的部署和操作
验证之二:docker部署MySQL


  • go服务操作MySQL数据库是很常见的,这里咱们也在云开发环境验证一下
  • 现在的环境已部署了docker服务,所以用docker安装MySQL最省事儿,一行命令即可
  1. docker run \
  2. --name mysql \
  3. -p 3306:3306 \
  4. -e MYSQL_ROOT_PASSWORD=123456 \
  5. -d \
  6. mariadb:10.3
复制代码

  • 微软服务器的网络情况真好,如下图,docker镜像下载得飞快

  • 进入容器
  1. docker exec -it mysql /bin/bash
复制代码

  • 现在已经在MySQL容器中了,执行以下命令直接进入mysql命令行模式
  1. mysql -uroot -p123456
复制代码

  • 新建名为demo的数据库
  1. create database demo;
  2. use demo;
复制代码

  • 数据库准备完毕,接下来接着刚才的module继续开发,先安装gorm和MySQL驱动
  1. go get -u gorm.io/gorm
  2. go get -u gorm.io/driver/mysql
复制代码

  • 再在gin上新增一个路由,对应的操作是接收求参数,在数据库新增一条记录,由于代码过于简单就不多废话了,在下面直接全部贴出来
  1. package main
  2. import (
  3.         "fmt"
  4.         "strconv"
  5.         "github.com/gin-gonic/gin"
  6.         "gorm.io/driver/mysql"
  7.         "gorm.io/gorm"
  8. )
  9. type Student struct {
  10.         gorm.Model
  11.         Name string
  12.         Age  uint64
  13. }
  14. // 全局数据库 db
  15. var db *gorm.DB
  16. // 包初始化函数,可以用来初始化 gorm
  17. func init() {
  18.         // 账号
  19.         username := "root"
  20.         // 密码
  21.         password := "123456"
  22.         // mysql 服务地址
  23.         host := "127.0.0.1"
  24.         // 端口
  25.         port := 3306
  26.         // 数据库名
  27.         Dbname := "demo"
  28.         // 拼接 mysql dsn,即拼接数据源,下方 {} 中的替换参数即可
  29.         // {username}:{password}@tcp({host}:{port})/{Dbname}?charset=utf8&parseTime=True&loc=Local&timeout=10s&readTimeout=30s&writeTimeout=60s
  30.         // timeout 是连接超时时间,readTimeout 是读超时时间,writeTimeout 是写超时时间,可以不填
  31.         dsn := fmt.Sprintf("%s:%s@tcp(%s:%d)/%s?charset=utf8&parseTime=True&loc=Local", username, password, host, port, Dbname)
  32.         // err
  33.         var err error
  34.         // 连接 mysql 获取 db 实例
  35.         db, err = gorm.Open(mysql.Open(dsn), &gorm.Config{})
  36.         if err != nil {
  37.                 panic("连接数据库失败, error=" + err.Error())
  38.         }
  39.         // 设置数据库连接池参数
  40.         sqlDB, _ := db.DB()
  41.         // 设置数据库连接池最大连接数
  42.         sqlDB.SetMaxOpenConns(10)
  43.         // 连接池最大允许的空闲连接数,如果没有sql任务需要执行的连接数大于2,超过的连接会被连接池关闭
  44.         sqlDB.SetMaxIdleConns(2)
  45.         // 建表
  46.         db.AutoMigrate(&Student{})
  47. }
  48. func main() {
  49.         router := gin.Default()
  50.         router.GET("/", func(c *gin.Context) {
  51.                 c.JSON(200, gin.H{
  52.                         "message": "hello world",
  53.                 })
  54.         })
  55.         router.GET("/create", func(c *gin.Context) {
  56.                 name := c.DefaultQuery("name", "小王子")
  57.                 ageStr := c.DefaultQuery("age", "1")
  58.                 var age uint64
  59.                 var err error
  60.                 if age, err = strconv.ParseUint(ageStr, 10, 32); err != nil {
  61.                         age = 1
  62.                 }
  63.                 fmt.Printf("name [%v], age [%v]\n", name, age)
  64.                 student := &Student{
  65.                         Name: name,
  66.                         Age:  age,
  67.                 }
  68.                 if err := db.Create(student).Error; err != nil {
  69.                         c.JSON(500, gin.H{
  70.                                 "code":    0,
  71.                                 "message": "insert db error",
  72.                         })
  73.                         return
  74.                 }
  75.                 c.JSON(200, gin.H{
  76.                         "code":    0,
  77.                         "message": fmt.Sprintf("insert db success [%+v]", student.Model.ID),
  78.                 })
  79.         })
  80.         router.Run()
  81. }
复制代码

  • 再次执行go run main.go运行应用,继续使用云开发环境给出的forward地址,如下图红色箭头所指,这次要在后面加上path和参数/create?name=Tom&age=10

  • 浏览器成返回新增记录的id

  • 登录MySQL查一下表,如下,数据全部写入成功
  1. root@5e9f15ab9ac1:/# mysql -uroot -p123456
  2. Welcome to the MariaDB monitor.  Commands end with ; or \g.
  3. Your MariaDB connection id is 42
  4. Server version: 10.3.37-MariaDB-1:10.3.37+maria~ubu2004 mariadb.org binary distribution
  5. Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
  6. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
  7. MariaDB [(none)]> use demo;
  8. Reading table information for completion of table and column names
  9. You can turn off this feature to get a quicker startup with -A
  10. Database changed
  11. MariaDB [demo]> select * from students;
  12. +----+-------------------------+-------------------------+------------+------+------+
  13. | id | created_at              | updated_at              | deleted_at | name | age  |
  14. +----+-------------------------+-------------------------+------------+------+------+
  15. |  1 | 2023-02-05 02:05:56.733 | 2023-02-05 02:05:56.733 | NULL       | Tom  |   10 |
  16. |  2 | 2023-02-05 02:09:35.537 | 2023-02-05 02:09:35.537 | NULL       | Tom  |   10 |
  17. |  3 | 2023-02-05 02:10:43.815 | 2023-02-05 02:10:43.815 | NULL       | Tom  |   10 |
  18. |  4 | 2023-02-05 02:10:45.069 | 2023-02-05 02:10:45.069 | NULL       | Tom  |   10 |
  19. |  5 | 2023-02-05 02:10:45.717 | 2023-02-05 02:10:45.717 | NULL       | Tom  |   10 |
  20. |  6 | 2023-02-05 02:10:46.000 | 2023-02-05 02:10:46.000 | NULL       | Tom  |   10 |
  21. |  7 | 2023-02-05 02:10:46.213 | 2023-02-05 02:10:46.213 | NULL       | Tom  |   10 |
  22. |  8 | 2023-02-05 02:10:46.578 | 2023-02-05 02:10:46.578 | NULL       | Tom  |   10 |
  23. |  9 | 2023-02-05 02:10:46.780 | 2023-02-05 02:10:46.780 | NULL       | Tom  |   10 |
  24. | 10 | 2023-02-05 02:10:46.976 | 2023-02-05 02:10:46.976 | NULL       | Tom  |   10 |
  25. | 11 | 2023-02-05 02:10:47.155 | 2023-02-05 02:10:47.155 | NULL       | Tom  |   10 |
  26. | 12 | 2023-02-05 02:10:47.359 | 2023-02-05 02:10:47.359 | NULL       | Tom  |   10 |
  27. +----+-------------------------+-------------------------+------------+------+------+
  28. 12 rows in set (0.000 sec)
复制代码
桌面版


  • 可能有些读者对网页面的IDE心存顾虑:操作流畅度和体验方面与传统桌面版有差距,或者说习惯了桌面版(主要是不像欣宸这么穷,破电脑只够运行浏览器),这时候还可以用本地桌面版远程连接云开发环境,这时候编码在本地vscode,而编译运行还在之前的云环境进行,既解决了习惯问题,又不影响白嫖微软服务器,依旧是快乐满满,具体操作方法如下,点击红色箭头所指的菜单

  • 此时浏览器就会拉起本地vscode

  • 拉起的过程可能没那么顺利,会要求您的vscode登录GitHub账号,然后再重新拉起,多折腾几次就可以了,拉起后的效果如下,和在本地运行项目看不出区别

  • 一切都符合预期,可见微软诚不欺我,4核8G服务器资源免费用,诚意满满
  • 这下似乎找不到偷懒的理由了,电脑破没关系,不想安装设置也没关系,没有服务器也没关系,GitHub都为你准备好了,还有什么理由不静下心来认真学习呢?
  • 了解更多codespaces详情,请访问官方资料:https://docs.github.com/zh/codespaces/overview
欢迎关注博客园:程序员欣宸

学习路上,你不孤单,欣宸原创一路相伴...

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x
回复

使用道具 举报

0 个回复

正序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

没腿的鸟

金牌会员
这个人很懒什么都没写!

标签云

快速回复 返回顶部 返回列表