313 lines
15 KiB
Markdown
313 lines
15 KiB
Markdown
|
||
|
||
因收到Google相关通知，网站将会择期关闭。相关通知内容
|
||
|
||
|
||
02 环境准备：如何安装和配置一个基本的 Go 开发环境？
|
||
你好，我是孔令飞。
|
||
|
||
上一讲我们讲了 IAM 系统的功能和架构，接下来的两讲，我们就将它部署到你的服务器上。不过，在正式部署之前，我们还需要准备一个 Go 开发环境，这是因为我们是通过编译源码来获取部署需要的二进制文件的。
|
||
|
||
因此，今天这一讲，我先手把手带你配置好一个 Go 的开发环境，供你以后开发、编译用，下一讲再带你部署 IAM 系统。
|
||
|
||
想要配置一个 Go 开发环境，我们可以通过以下 4 步实现：
|
||
|
||
|
||
Linux 服务器申请和配置
|
||
依赖安装和配置
|
||
Go 编译环境安装和配置
|
||
Go 开发 IDE 安装和配置
|
||
|
||
|
||
Linux 服务器申请和配置
|
||
|
||
毫无疑问，要安装一个 Go 开发环境，你首先需要有一个 Linux 服务器。Linux 服务器有很多操作系统可供选择，例如：CentOS、Ubuntu、RHEL、Debian 等，但目前生产环境用得最多的还是 CentOS 系统，为了跟生产环境保持一致，我们选择当前最新的 CentOS 版本：CentOS 8.2。
|
||
|
||
因为本专栏的所有操作都是在 CentOS 8.2 系统上进行的，为了避免环境不一致导致的操作失败，我建议你也使用 CentOS 8.2。安装一个 Linux 服务器需要两步：服务器申请和配置。
|
||
|
||
Linux 服务器申请
|
||
|
||
我们可以通过以下 3 种方式来安装一个 CentOS 8.2 系统。
|
||
|
||
|
||
在物理机上安装一个 CentOS 8.2 系统。
|
||
在 Windows/MacBook 上安装虚拟机管理软件，用虚拟机管理软件创建 CentOS 8.2 虚拟机。其中，Windows 建议用 VMWare Workstation 来创建虚拟机，MacBook 建议用 VirtualBox 来创建虚拟机。
|
||
在诸如腾讯云、阿里云、华为云等平台上购买一个虚拟机，并预装 CentOS 8.2 系统。
|
||
|
||
|
||
Linux 服务器配置
|
||
|
||
申请完 Linux 服务之后，我们需要通过 SecureCRT 或 Xshell 等工具登录 Linux 服务器，并对服务器做一些简单必要的配置，包括创建普通用户、添加 sudoers、配置 $HOME/.bashrc 文件。接下来，我们一一来说。
|
||
|
||
第一步，用Root 用户登录Linux 系统，并创建普通用户。
|
||
|
||
一般来说，一个项目会由多个开发人员协作完成，为了节省企业成本，公司不会给每个开发人员都配备一台服务器，而是让所有开发人员共用一个开发机，通过普通用户登录开发机进行开发。因此，为了模拟真实的企业开发环境，我们也通过一个普通用户的身份来进行项目的开发，创建方法如下：
|
||
|
||
# useradd going # 创建 going 用户，通过 going 用户登录开发机进行开发
|
||
# passwd going # 设置密码
|
||
Changing password for user going.
|
||
New password:
|
||
Retype new password:
|
||
passwd: all authentication tokens updated successfully.
|
||
|
||
|
||
不仅如此，使用普通用户登录和操作开发机也可以保证系统的安全性，这是一个比较好的习惯，所以我们在日常开发中也要尽量避免使用 Root 用户。
|
||
|
||
第二步，添加 sudoers。
|
||
|
||
我们知道很多时候，普通用户也要用到 Root 的一些权限，但 Root 用户的密码一般是由系统管理员维护并定期更改的，每次都向管理员询问密码又很麻烦。因此，我建议你将普通用户加入到 sudoers 中，这样普通用户就可以通过 sudo 命令来暂时获取 Root 的权限。具体来说，你可以执行如下命令添加：
|
||
|
||
# sed -i '/^root.*ALL=(ALL).*ALL/a\going\tALL=(ALL) \tALL' /etc/sudoers
|
||
|
||
|
||
第三步，替换 CentOS 8.4 系统中自带的 Yum 源。
|
||
|
||
由于 Red Hat 提前宣布 CentOS 8 于 2021 年 12 月 31 日停止维护，官方的 Yum 源已不可使用，所以需要切换官方的 Yum 源，这里选择阿里提供的 Yum 源。切换命令如下：
|
||
|
||
# mv /etc/yum.repos.d /etc/yum.repos.d.bak # 先备份原有的 Yum 源
|
||
# mkdir /etc/yum.repos.d
|
||
# wget -O /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-vault-8.5.2111.repo
|
||
# yum clean all && yum makecache
|
||
|
||
|
||
第四步，用新的用户名（going）和密码登录Linux 服务器。这一步也可以验证普通用户是否创建成功。
|
||
|
||
第五步，配置 $HOME/.bashrc 文件。
|
||
|
||
我们登录新服务器后的第一步就是配置 \(HOME/.bashrc 文件，以使 Linux 登录 shell 更加易用，例如配置 `LANG` 解决中文乱码，配置 `PS1` 可以避免整行都是文件路径，并将 `\)HOME/bin加入到PATH` 路径中。配置后的内容如下：
|
||
|
||
# .bashrc
|
||
|
||
# User specific aliases and functions
|
||
|
||
alias rm='rm -i'
|
||
alias cp='cp -i'
|
||
alias mv='mv -i'
|
||
|
||
# Source global definitions
|
||
if [ -f /etc/bashrc ]; then
|
||
. /etc/bashrc
|
||
fi
|
||
|
||
# User specific environment
|
||
# Basic envs
|
||
export LANG="en_US.UTF-8" # 设置系统语言为 en_US.UTF-8，避免终端出现中文乱码
|
||
export PS1='[\u@dev \W]\$ ' # 默认的 PS1 设置会展示全部的路径，为了防止过长，这里只展示："用户名@dev 最后的目录名"
|
||
export WORKSPACE="$HOME/workspace" # 设置工作目录
|
||
export PATH=$HOME/bin:$PATH # 将 $HOME/bin 目录加入到 PATH 变量中
|
||
|
||
# Default entry folder
|
||
cd $WORKSPACE # 登录系统，默认进入 workspace 目录
|
||
|
||
|
||
有一点需要我们注意，在 export PATH 时，最好把 $PATH 放到最后，因为我们添加到目录中的命令是期望被优先搜索并使用的。配置完 $HOME/.bashrc 后，我们还需要创建工作目录 workspace。将工作文件统一放在 $HOME/workspace 目录中，有几点好处。
|
||
|
||
|
||
可以使我们的$HOME目录保持整洁，便于以后的文件查找和分类。
|
||
如果哪一天 /分区空间不足，可以将整个 workspace 目录 mv 到另一个分区中，并在 /分区中保留软连接，例如：/home/going/workspace -> /data/workspace/。
|
||
如果哪天想备份所有的工作文件，可以直接备份 workspace。
|
||
|
||
|
||
具体的操作指令是$ mkdir -p $HOME/workspace。配置好 $HOME/.bashrc 文件后，我们就可以执行 bash 命令将配置加载到当前 shell 中了。
|
||
|
||
至此，我们就完成了 Linux 开发机环境的申请及初步配置。
|
||
|
||
依赖安装和配置
|
||
|
||
在 Linux 系统上安装 IAM 系统会依赖一些 RPM 包和工具，有些是直接依赖，有些是间接依赖。为了避免后续的操作出现依赖错误，例如，因为包不存在而导致的编译、命令执行错误等，我们先统一依赖安装和配置。安装和配置步骤如下。
|
||
|
||
第一步，安装依赖。
|
||
|
||
首先，我们在 CentOS 系统上通过 yum 命令来安装所需工具的依赖，安装命令如下：
|
||
|
||
$ sudo yum -y install make autoconf automake cmake perl-CPAN libcurl-devel libtool gcc gcc-c++ glibc-headers zlib-devel git-lfs telnet lrzsz jq expat-devel openssl-devel
|
||
|
||
|
||
虽然有些 CentOS 8.2 系统已经默认安装这些依赖了，但是为了确保它们都能被安装，我仍然会尝试安装一遍。如果系统提示 Package xxx is already installed.，说明已经安装好了，你直接忽略即可。
|
||
|
||
第二步，安装 Git。
|
||
|
||
因为安装 IAM 系统、执行 go get 命令、安装 protobuf 工具等都是通过 Git 来操作的，所以接下来我们还需要安装 Git。由于低版本的 Git 不支持--unshallow 参数，而 go get 在安装 Go 包时会用到 git fetch --unshallow 命令，因此我们要确保安装一个高版本的 Git，具体的安装方法如下：
|
||
|
||
$ cd /tmp
|
||
$ wget --no-check-certificate https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.36.1.tar.gz
|
||
$ tar -xvzf git-2.36.1.tar.gz
|
||
$ cd git-2.36.1/
|
||
$ ./configure
|
||
$ make
|
||
$ sudo make install
|
||
$ git --version # 输出 git 版本号，说明安装成功
|
||
git version 2.36.1
|
||
|
||
|
||
注意啦，按照上面的步骤安装好之后，我们要把 Git 的二进制目录添加到 PATH 路径中，不然 Git 可能会因为找不到一些命令而报错。你可以通过执行以下命令添加目录：
|
||
|
||
tee -a $HOME/.bashrc <<'EOF'
|
||
# Configure for git
|
||
export PATH=/usr/local/libexec/git-core:$PATH
|
||
EOF
|
||
|
||
|
||
第三步，配置 Git。我们直接执行如下命令配置 Git：
|
||
|
||
$ git config --global user.name "Lingfei Kong" # 用户名改成自己的
|
||
$ git config --global user.email "[email protected]" # 邮箱改成自己的
|
||
$ git config --global credential.helper store # 设置 Git，保存用户名和密码
|
||
$ git config --global core.longpaths true # 解决 Git 中 'Filename too long' 的错误
|
||
|
||
|
||
除了按照上述步骤配置 Git 之外，我们还有几点需要注意。
|
||
|
||
首先，在 Git 中，我们会把非 ASCII 字符叫做 Unusual 字符。这类字符在 Git 输出到终端的时候默认是用 8 进制转义字符输出的（以防乱码），但现在的终端多数都支持直接显示非 ASCII 字符，所以我们可以关闭掉这个特性，具体的命令如下：
|
||
|
||
$ git config --global core.quotepath off
|
||
|
||
|
||
其次，GitHub 限制最大只能克隆 100M 的单个文件，为了能够克隆大于 100M 的文件，我们还需要安装 Git Large File Storage，安装方式如下：
|
||
|
||
$ git lfs install --skip-repo
|
||
|
||
|
||
好啦，现在我们就完成了依赖的安装和配置。
|
||
|
||
Go 编译环境安装和配置
|
||
|
||
我们知道，Go 是一门编译型语言，所以在部署 IAM 系统之前，我们需要将代码编译成可执行的二进制文件。因此我们需要安装 Go 编译环境。
|
||
|
||
除了 Go，我们也会用 gRPC 框架展示 RPC 通信协议的用法，所以我们也需要将 ProtoBuf 的.proto 文件编译成 Go 语言的接口。因此，我们也需要安装 ProtoBuf 的编译环境。
|
||
|
||
Go 编译环境安装和配置
|
||
|
||
安装 Go 语言相对来说比较简单，我们只需要下载源码包、设置相应的环境变量即可。
|
||
|
||
首先，我们从 Go 语言官方网站下载对应的 Go 安装包以及源码包，这里我下载的是 go1.18.3 版本：
|
||
|
||
$ wget -P /tmp/ https://golang.google.cn/dl/go1.18.3.linux-amd64.tar.gz
|
||
|
||
|
||
接着，我们完成解压和安装，命令如下：
|
||
|
||
$ mkdir -p $HOME/go
|
||
$ tar -xvzf /tmp/go1.18.3.linux-amd64.tar.gz -C $HOME/go
|
||
$ mv $HOME/go/go $HOME/go/go1.18.3
|
||
|
||
|
||
接着，我们执行以下命令，将下列环境变量追加到$HOME/.bashrc 文件中。
|
||
|
||
$ tee -a $HOME/.bashrc <<'EOF'
|
||
# Go envs
|
||
export GOVERSION=go1.18.3 # Go 版本设置
|
||
export GO_INSTALL_DIR=$HOME/go # Go 安装目录
|
||
export GOROOT=$GO_INSTALL_DIR/$GOVERSION # GOROOT 设置
|
||
export GOPATH=$WORKSPACE/golang # GOPATH 设置
|
||
export PATH=$GOROOT/bin:$GOPATH/bin:$PATH # 将 Go 语言自带的和通过 go install 安装的二进制文件加入到 PATH 路径中
|
||
export GO111MODULE="on" # 开启 Go moudles 特性
|
||
export GOPROXY=https://goproxy.cn,direct # 安装 Go 模块时，代理服务器设置
|
||
export GOPRIVATE=
|
||
export GOSUMDB=off # 关闭校验 Go 依赖包的哈希值
|
||
EOF
|
||
|
||
|
||
为什么要增加这么多环境变量呢？这是因为，Go 语言是通过一系列的环境变量来控制 Go 编译器行为的。因此，我们一定要理解每一个环境变量的含义。
|
||
|
||
|
||
|
||
因为 Go 以后会用 Go modules 来管理依赖，所以我建议你将 GO111MODULE 设置为 on。
|
||
|
||
在使用模块的时候，$GOPATH 是无意义的，不过它还是会把下载的依赖储存在 $GOPATH/pkg/mod 目录中，也会把 go install 的二进制文件存放在 $GOPATH/bin 目录中。
|
||
|
||
另外，我们还要将$GOPATH/bin、$GOROOT/bin 加入到 Linux 可执行文件搜索路径中。这样一来，我们就可以直接在 bash shell 中执行 go 自带的命令，以及通过 go install 安装的命令。
|
||
|
||
然后就是进行测试了，如果我们执行 go version 命令可以成功输出 Go 的版本，就说明 Go 编译环境安装成功。具体的命令如下：
|
||
|
||
$ bash
|
||
$ go version
|
||
go version go1.18.3 linux/amd64
|
||
|
||
|
||
最后，初始化工作区。
|
||
|
||
本专栏使用的 Go 版本为 go1.18.3，go1.18.3 支持多模块工作区，所以这里也需要初始化工作区。初始化命令如下：
|
||
|
||
$ mkdir -p $GOPATH && cd $GOPATH
|
||
$ go work init
|
||
$ go env GOWORK # 执行此命令，查看 go.work 工作区文件路径
|
||
/home/going/workspace/golang/go.work
|
||
|
||
|
||
ProtoBuf 编译环境安装
|
||
|
||
接着，我们再来安装 protobuf 的编译器 protoc。protoc 需要 protoc-gen-go 来完成 Go 语言的代码转换，因此我们需要安装 protoc 和 protoc-gen-go 这 2 个工具。它们的安装方法比较简单，你直接看我下面给出的代码和操作注释就可以了。
|
||
|
||
# 第一步：安装 protobuf
|
||
$ cd /tmp/
|
||
$ git clone -b v3.21.1 --depth=1 https://github.com/protocolbuffers/protobuf
|
||
$ cd protobuf
|
||
$ ./autogen.sh
|
||
$ ./configure
|
||
$ make
|
||
$ sudo make install
|
||
$ protoc --version # 查看 protoc 版本，成功输出版本号，说明安装成功
|
||
libprotoc 3.21.1
|
||
|
||
# 第二步：安装 protoc-gen-go
|
||
$ go install github.com/golang/protobuf/[email protected]
|
||
|
||
|
||
当你第一次执行 go install 命令的时候，因为本地无缓存，所以需要下载所有的依赖模块。因此安装速度会比较慢，请你耐心等待。
|
||
|
||
Go 开发 IDE 安装和配置
|
||
|
||
编译环境准备完之后，你还需要一个代码编辑器才能开始 Go 项目开发。为了提高开发效率，你还需要将这个编辑器配置成 Go IDE。
|
||
|
||
目前，GoLand、VSCode 这些 IDE 都很优秀，但它们都是 Windows 系统下的 IDE。在 Linux 系统下我们可以选择将 Vim 配置成 Go IDE。熟练 Vim IDE 操作之后，开发效率不输 GoLand 和 VSCode。有多种方法可以配置一个Vim IDE，这里我选择使用 vim-go 将 Vim 配置成一个 Go IDE。vim-go 是社区比较受欢迎的 Vim Go 开发插件，可以用来方便地将一个 Vim 配置成 Vim IDE。
|
||
|
||
Vim IDE 的安装和配置分为以下2步。
|
||
|
||
第一步，安装 vim-go。
|
||
|
||
安装命令如下：
|
||
|
||
$ rm -f $HOME/.vim; mkdir -p ~/.vim/pack/plugins/start/
|
||
$ git clone --depth=1 https://github.com/fatih/vim-go.git ~/.vim/pack/plugins/start/vim-go
|
||
|
||
|
||
第二步，Go 工具安装。
|
||
|
||
vim-go 会用到一些 Go 工具，比如在函数跳转时会用到 guru、godef 工具，在格式化时会用到 goimports，所以你也需要安装这些工具。安装方式如下：执行 vi /tmp/test.go，然后输入 :GoInstallBinaries 安装 vim-go 需要的工具。
|
||
|
||
安装后的 Go IDE 常用操作的按键映射如下表所示：
|
||
|
||
|
||
|
||
总结
|
||
|
||
这一讲，我们一起安装和配置了一个 Go 开发环境，为了方便你回顾，我将安装和配置过程绘制成了一个流程图，如下所示。
|
||
|
||
|
||
|
||
有了这个开发环境，接下来我们就可以在学习的过程中随时进行编码，来熟悉和验证知识点了，所以你一定要在学习后面的课程之前先完成这一讲的部署。
|
||
|
||
课后练习
|
||
|
||
|
||
试着编写一个 main.go，在 main 函数中打印 Hello World，并执行 go run main.go 运行代码，测试 Go 开发环境。
|
||
试着编写一个 main.go，代码如下：
|
||
|
||
|
||
package main
|
||
|
||
import "fmt"
|
||
|
||
func main() {
|
||
fmt.Println("Hello World")
|
||
}
|
||
|
||
|
||
将鼠标放在 Println 上，键入 Enter 键跳转到函数定义处，键入 Ctrl + I 返回到跳转点。
|
||
|
||
期待在留言区看到你的思考和答案，也欢迎和我一起探讨环境安装过程中的问题，我们下一讲见！
|
||
|
||
|
||
|
||
|