zoukankan      html  css  js  c++  java
  • go包管理之glide

    go语言的包是没有中央库来统一管理的,通过使用go get命令从远程代码库(github.com,goolge code 等)拉取,直接跳过中央版本库的约束,让代码的拉取直接基于源代码版本控制库,开发者间的协同直接依赖于源代码的版本控制。直接去除了库版本的概念。没有明显的包版本标识,感觉还是有点不适应,官方的建议是把外部依赖的代码全部复制到自己可控的源代码库中,进行统一管理,从而做到对依赖包的可控管理。     

    1.5版本的vendor目录特性后,官方wiki推荐了多种支持这种特性的包管理工具如:Godep、gv、gvt、glide、Govendor等。下面说明下glide的使用。

    glide

    glide是Go的包管理工具,用于解决依赖关联。支持语义化版本,支持Git、Svn等,支持Go工具链,支持vendor目录,支持从Godep、GB、GPM、Gom倒入,支持私有的Repos和Forks。官网:https://glide.sh/

    使用glide管理的工程目录结构如下:

    - $GOPATH/src/myProject (Your project)
      |
      |-- glide.yaml
      |
      |-- glide.lock
      |
      |-- main.go (Your main go code can live here)
      |
      |-- mySubpackage (You can create your own subpackages, too)
      |    |
      |    |-- foo.go
      |
      |-- vendor
           |-- github.com
                |
                |-- Masterminds
                      |
                      |-- ... etc.

    glide命令

    # 初始化glide配置,扫描源码,生成依赖包文件glide.yaml
    glide init
    
    # 添加新的包(glide会从代码中解析并导入import包,此外可使用glide get直接下载依赖包)
    glide get [package name]
    
    # 根据glide.yaml更新包(包新版源码)
    glide update
    glide up
    
    # 根据glide.yaml安装包
    glide install
    
    # 返回当前项目的名称
    glide name
    
    # 列出当前项目已安装的包
    glide list
    
    # 替换包的镜像
    glide mirror set [original] [replacement]
    glide mirror set [original] [replacement] --vcs [type]
    
    # 移除包的镜像
    glide mirror remove [original]
    
    # 获取包的镜像列表
    glide mirror list

    常见问题:

    [WARN]  Unable to checkout golang.org/x/crypto
    [ERROR] Update failed for golang.org/x/crypto: Cannotdetect VCS
    [ERROR] Failed to do initial checkout of config:Cannot detect VCS

    由于国外某些网站不能访问,导致许多Golang的依赖包不能通过go get下载,此时需要glide mirror。

    glide mirror特别适用于不能访问一些站点,导致很Golang的依赖包不能通过go get下载的情况。可以通过配置将墙了的版本库 URL 映射到没被墙的 URL,甚至也可以映射到本地版本库。

    glide mirror set golang.org/x/crypto github.com/golang/crypto --vcs git

    执行上述命令后再执行glide install/glide up即可。

    注:glide搜索到的包应该以git或svn等vcs,但上述proxy、websocket和ctxhttp是net的子包,golang.org/x/net/采用git管理。同样,golang.org/x/sys采用git管理,windows是sys的子目录。此时,可在glide.yaml中指定golang.org/x/net和golang.org/x/sys的子包关系:

    - package: golang.org/x/net 
      subpackages:
      - proxy 
      - websocket 
      - context/ctxhttp
    - package: golang.org/x/sys
      subpackages:
      - windows

    此时,直接设置git管理包的镜像即可,mirror设置:

    glide mirror set https://golang.org/x/net https://github.com/golang/net --vcs git
    glide mirror set golang.org/x/sys https://github.com/golang/sys --vcs git

    注:glide mirror的镜像配置写入到$HOME/.glide/mirrors.yaml中。$HOME/.glide/目录下还有一个很重要的目录cache本地 cache,每次更新代码时, glide 都会在本地保存 cache,以备下次 glide install 使用 。

    注:github上一般都镜像了golang.org上的大部分源码,可到网站https://github.com/golang/查询。

    若glide mirror不起作用,可以直接下载github上的库(glide get),然后软连接cache下的库。

    glide get github.com/golang/sys
    ln -s https-github.com-golang-sys/ https-golang.org-x-sys

    可参考:Goland.org包换国内源 https://www.jianshu.com/p/cefec4cd3a22

    glide.yaml解析

    glide.yaml包含工程和依赖包信息,如下:

    package: github.com/Masterminds/glide
    homepage: https://masterminds.github.io/glide
    license: MIT
    owners:
    - name: Matt Butcher
      email: technosophos@gmail.com
      homepage: http://technosophos.com
    - name: Matt Farina
      email: matt@mattfarina.com
      homepage: https://www.mattfarina.com
    ignore:
    - appengine
    excludeDirs:
    - node_modules
    import:
    - package: gopkg.in/yaml.v2
    - package: github.com/Masterminds/vcs
      version: ^1.2.0
      repo:    git@github.com:Masterminds/vcs
      vcs:     git
    - package: github.com/codegangsta/cli
      version: f89effe81c1ece9c5b0fda359ebd9cf65f169a51
    - package: github.com/Masterminds/semver
      version: ^1.0.0
    # 测试导入包
    testImport:
    - package: github.com/arschles/assert

    glide.yaml中的这些元素的解释如下:

    • package:顶部的 package 是它所在GOPATH的位置,glide 将从该位置下开始导包。
    • homepage:该项目的详情页面。
    • license:许可证标识,可以是SPDX license字符串或文件路径。
    • owners:项目的所有者信息,便于接受漏洞信息。
    • ignore:忽略导入的包,注意是包而不是目录。
    • excludeDirs:排除扫描依赖的目录。
    • import:import 的包列表:
      • package:导入包的名称,必填。软件包名称遵循go工具所用的相同模式。这意味着:1、映射到VCS远程位置的软件包名称以.git,.bzr,.hg或.svn结尾。 例如,example.com/foo/pkg.git/subpkg。2、GitHub, BitBucket, Launchpad, IBM Bluemix Services, and Go on Google Source是特殊情况,不需要 VCS 扩展。
      • version:可以为semantic version, semantic version range, branch, tag 或者 commit id。
      • repo:如果包名称不是repo位置或这是一个私人存储库,它可以去这里。 该软件包将从repo签出并放在软件包名称指定的位置。 这允许使用fork。
      • vcs:要使用的VCS,如git,hg,bzr或svn。仅当无法从名称中检测到类型时才需要。例如,以.git或GitHub结尾的仓库可以被检测为Git。 对于Bitbucket的repo,我们可以联系API来发现类型。
      • subpackages:在存储库中使用的包的记录。这不包括存储库中的所有包,而是包括正在使用的包。
      • os:用于过滤的操作系统的列表。如果设置它将比较当前运行时操作系统与指定的操作系统,并且只有获取匹配的依赖。如果未设置过滤,则跳过。这些名称与构建标志和GOOS环境变量中使用的名称相同。
      • arch:用于过滤的体系结构列表。如果设置它将比较当前运行时架构与指定的架构,并且只有在匹配时获取依赖关系。如果未设置过滤,则跳过。名称与构建标志和GOARCH环境变量中使用的名称相同。
    • testImport:在导入中未列出的测试中使用的软件包列表。每个包具有与导入下列出的相同的详细信息。

    edgex-go采用glide管理,其glide.yaml文件内容如下:

    package: github.com/edgexfoundry/edgex-go
    import:
    - package: github.com/BurntSushi/toml
    - package: github.com/eclipse/paho.mqtt.golang
    - package: github.com/go-zoo/bone
    - package: github.com/gorilla/mux
    - package: github.com/hashicorp/consul
      subpackages:
      - api
    - package: github.com/pebbe/zmq4
    - package: github.com/robfig/cron
    - package: go.uber.org/zap
    - package: gopkg.in/mgo.v2
      subpackages:
      - bson
    - package: gopkg.in/yaml.v2
    - package: github.com/mattn/go-xmpp
    - package: github.com/satori/go.uuid

    glide版本号指定规则如下:

    =: equal (aliased to no operator)
    !=: not equal
    >: greater than
    <: less than
    >=: greater than or equal to
    <=: less than or equal to
    
    1.2 - 1.4.5 which is equivalent to >= 1.2, <= 1.4.5
    2.3.4 - 4.5 which is equivalent to >= 2.3.4, <= 4.5
    1.2.x is equivalent to >= 1.2.0, < 1.3.0
    
    >= 1.2.x is equivalent to >= 1.2.0
    <= 2.x is equivalent to < 3
    * is equivalent to >= 0.0.0
    
    ~1.2.3 is equivalent to >= 1.2.3, < 1.3.0
    ~1 is equivalent to >= 1, < 2
    ~2.3 is equivalent to >= 2.3, < 2.4
    ~1.2.x is equivalent to >= 1.2.0, < 1.3.0
    ~1.x is equivalent to >= 1, < 2
    
    ^1.2.3 is equivalent to >= 1.2.3, < 2.0.0
    ^1.2.x is equivalent to >= 1.2.0, < 2.0.0
    ^2.3 is equivalent to >= 2.3, < 3
    ^2.x is equivalent to >= 2.0.0, < 3

    要注意的是安装完成之后,会生成glide.lock文件,锁定安装包的版本,下次再执行 glide install 时,会直接读这个文件下载确定的版本。

    参考:

    1. Golang包管理工具glide简介

    https://www.cnblogs.com/xiwang/p/5870941.html?hmsr=toutiao.io&utm_medium=toutiao.io&utm_source=toutiao.io

    2. Golang学习--包管理工具glide

    https://www.cnblogs.com/CraryPrimitiveMan/p/7828357.html

    3. Golang依赖管理工具:glide从入门到精通使用

    https://studygolang.com/articles/10453?fr=email

    4.Goland.org包换国内源 https://www.jianshu.com/p/cefec4cd3a22

    5.edgex-go

    6.  edgex0.7.1编译

  • 相关阅读:
    剑指Offer--反转链表
    剑指Offer--链表中倒数第k个结点
    面向对象的六原则一法则
    常见错误汇总
    记人生第一次CF体验
    Game of Credit Cards
    Shell Game (模拟)
    数列分块入门 1 LibreOJ
    范德蒙恒等式
    C. Vasya and String (尺取法)
  • 原文地址:https://www.cnblogs.com/embedded-linux/p/10367097.html
Copyright © 2011-2022 走看看