Etcd教程 — 第一章 Etcd简介、Etcd单机安装

Etcd教程 — 第一章 Etcd简介、Etcd单机安装

  • 1 Etcd介绍
    • 1.1 介绍
    • 1.2 etcd特点
  • 2 Etcd单机安装
    • 2.1 安装方式
      • 2.1.1 yum install etcd
      • 2.1.2 通过系统工具安装etcd【版本比较滞后】
      • 2.1.3 二进制包、源码编译、Docker容器【推荐方式】
    • 2.2 Linux安装Etcd
      • 2.2.1 创建执行脚本
      • 2.2.2 脚本内容
      • 2.2.3 执行脚本里的命令
      • 2.2.4 查看Etcd安装是否成功
        • 2.2.4.1 查看Etcd服务端安装是否成功
        • 2.2.4.2 查看Etcd客户端安装是否成功
      • 2.2.5 启动Etcd
      • 2.2.6 测试
    • 2.3 macOS (Darwin)安装Etcd
    • 2.4 Docker安装Etcd
      • 2.4.1安装Etcd的命令(1)
      • 2.4.2 Docker查看etcd版本及使用

1 Etcd介绍

1.1 介绍

etcd 是使用Go语言开发的一个开源的、高可用的分布式key-value存储系统,可以用于配置共享和服务的注册和发现。

1.2 etcd特点

etcd 具有以下特点:

完全复制:集群中的每个节点都可以使用完整的存档
高可用性:Etcd可用于避免硬件的单点故障或网络问题
一致性:每次读取都会返回跨多主机的最新写入
简单:包括一个定义良好、面向用户的API(gRPC)
安全:实现了带有可选的客户端证书身份验证的自动化TLS
快速:每秒10000次写入的基准速度
可靠:使用Raft算法实现了强一致、高可用的服务存储目录

2 Etcd单机安装

2.1 安装方式

2.1.1 yum install etcd

2.1.2 通过系统工具安装etcd【版本比较滞后】

2.1.3 二进制包、源码编译、Docker容器【推荐方式】

下载安装包地址:https://github.com/etcd-io/etcd/tags

选择最新版本,同时里面还有Linux、macOS (Darwin)、Docker这三种安装方式的步骤以及安装包。

Etcd教程 — 第一章 Etcd简介、Etcd单机安装_第1张图片
注:2.2到2.4的安装方式在github上都有写,详见:https://github.com/etcd-io/etcd/releases/tag/v3.5.4

2.2 Linux安装Etcd

2.2.1 创建执行脚本

在 linux的 /opt/soft/etcd/ 目录下创建一个脚本文件:

vim etcd

2.2.2 脚本内容

ETCD_VER=v3.5.4

# choose either URL 翻译:选择下面两个任意一个地址即可
GOOGLE_URL=https://storage.googleapis.com/etcd
GITHUB_URL=https://github.com/etcd-io/etcd/releases/download
DOWNLOAD_URL=${GOOGLE_URL}

rm -f /opt/soft/etcd/etcd-${ETCD_VER}-linux-amd64.tar.gz
rm -rf /opt/soft/etcd/etcd-download-test && mkdir -p /opt/soft/etcd/etcd-download-test

curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz -o /opt/soft/etcd/etcd-${ETCD_VER}-linux-amd64.tar.gz
tar -zxvf /opt/soft/etcd/etcd-${ETCD_VER}-linux-amd64.tar.gz -C /opt/soft/etcd/etcd-download-test --strip-components=1
rm -f /opt/soft/etcd/etcd-${ETCD_VER}-linux-amd64.tar.gz

#查看安装是否成功的相关命令
/opt/soft/etcd/etcd-download-test/etcd --version
/opt/soft/etcd/etcd-download-test/etcdctl version
/opt/soft/etcd/etcd-download-test/etcdutl version

2.2.3 执行脚本里的命令

/opt/soft/etcd 执行:

./etcd

如果在执行时提示权限不够,则需要授权,然后再次执行即可:

chmod 777 etcd

2.2.4 查看Etcd安装是否成功

2.2.4.1 查看Etcd服务端安装是否成功
/opt/soft/etcd/etcd-download-test/etcd --version

如下显示则安装成功:

etcd Version: 3.5.4
Git SHA: 08407ff76
Go Version: go1.16.15
Go OS/Arch: linux/amd64

注意:需要将etcd加入到环境变量中,否则会在 3.3.3 执行 goreman启动命令 步骤时报 /bin/sh: etcd: 未找到命令

vim ~/.bashrc

将etcd环境变量添加到文件末尾。

export GOROOT=/usr/local/go #GOROOT是系统上安装Go软件包的位置。
export GOPATH=/root/go/GOPATH #GOPATH是工作目录的位置。这个是自己创建的,想放在哪都行
export ETCD=/opt/soft/etcd/etcd-download-test #ETCD

#export PATH=$GOPATH/bin:$GOROOT/bin:$PATH
export PATH=$GOPATH/bin:$GOROOT/bin:$ETCD:$PATH
export GOPROXY="https://goproxy.cn"

加完后按esc键退出编辑模式,输入:wq保存退出。

source ~/.bashrc 更新配置文件。

2.2.4.2 查看Etcd客户端安装是否成功
/opt/soft/etcd/etcd-download-test/etcdctl version

如下显示则安装成功:

etcdctl version: 3.5.4
API version: 3.5

2.2.5 启动Etcd

# start a local etcd server
/opt/soft/etcd/etcd-download-test/etcd

2.2.6 测试

# write,read to etcd
/opt/soft/etcd/etcd-download-test/etcdctl --endpoints=localhost:2379 put foo bar
/opt/soft/etcd/etcd-download-test/etcdctl --endpoints=localhost:2379 get foo

2.3 macOS (Darwin)安装Etcd

ETCD_VER=v3.5.4

# choose either URL 翻译:选择下面两个任意一个地址即可

GOOGLE_URL=https://storage.googleapis.com/etcd
GITHUB_URL=https://github.com/etcd-io/etcd/releases/download
DOWNLOAD_URL=${GOOGLE_URL}

rm -f /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
rm -rf /tmp/etcd-download-test && mkdir -p /tmp/etcd-download-test

curl -L ${DOWNLOAD_URL}/${ETCD_VER}/etcd-${ETCD_VER}-darwin-amd64.zip -o /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
unzip /tmp/etcd-${ETCD_VER}-darwin-amd64.zip -d /tmp && rm -f /tmp/etcd-${ETCD_VER}-darwin-amd64.zip
mv /tmp/etcd-${ETCD_VER}-darwin-amd64/* /tmp/etcd-download-test && rm -rf /tmp/etcd-${ETCD_VER}-darwin-amd64

/tmp/etcd-download-test/etcd --version
/tmp/etcd-download-test/etcdctl version
/tmp/etcd-download-test/etcdutl version

2.4 Docker安装Etcd

Docker安装Etcd前,需要先在Linux上安装Docker,Docker的安装步骤参见:centos7安装docker

2.4.1安装Etcd的命令(1)

rm -rf /tmp/etcd-data.tmp && mkdir -p /tmp/etcd-data.tmp && \
  docker rmi gcr.io/etcd-development/etcd:v3.5.4 || true && \
  docker run \
  -p 2379:2379 \
  -p 2380:2380 \
  --mount type=bind,source=/tmp/etcd-data.tmp,destination=/etcd-data \
  --name etcd-gcr-v3.5.4 \
  gcr.io/etcd-development/etcd:v3.5.4 \
  /usr/local/bin/etcd \
  --name s1 \
  --data-dir /etcd-data \
  --listen-client-urls http://0.0.0.0:2379 \
  --advertise-client-urls http://0.0.0.0:2379 \
  --listen-peer-urls http://0.0.0.0:2380 \
  --initial-advertise-peer-urls http://0.0.0.0:2380 \
  --initial-cluster s1=http://0.0.0.0:2380 \
  --initial-cluster-token tkn \
  --initial-cluster-state new \
  --log-level info \
  --logger zap \
  --log-outputs stderr

安装中遇到的一些问题:
Q1: 提示仓库里没有 gcr.io/etcd-development/etcd:v3.5.4

Error: No such image: gcr.io/etcd-development/etcd:v3.5.4
Unable to find image 'gcr.io/etcd-development/etcd:v3.5.4' locally
docker: Error response from daemon: Get "https://gcr.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers).
See 'docker run --help'.

使用 docker search etcd 搜索仓库里的etcd:

NAME                             DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
bitnami/etcd                     Bitnami etcd Docker Image                       126                  [OK]
elcolio/etcd                     Tiny Etcd Container with TLS support and etc…   88                   [OK]
microbox/etcd                    Trusted Automated etcd image (17MB size)        38                   [OK]
appcelerator/etcd                etcd                                            13                   [OK]
xieyanze/etcd3                   etcd v3.0.9 image                               12                   [OK]
monsantoco/etcd-aws-cluster                                                      12                   [OK]
nikfoundas/etcd-viewer           etcd key-value store viewer and editor          8                    [OK]
rancher/etcd                                                                     4
ibmcom/etcd                      Docker Image for IBM Cloud private-CE (Commu…   2
pachyderm/etcd                                                                   1
kubesphere/etcd                                                                  1
ibmcom/etcd-ppc64le              Docker Image for IBM Cloud Private-CE (Commu…   1
mesosphere/etcd-mesos            etcd framework for mesos                        1
openshift/etcd-20-centos7        OpenShift etcd v2.0 with clustering support     1
gasparekatapy/etcd               Updated version of splazit/etcd                 0
kope/etcd                                                                        0
docker/desktop-kubernetes-etcd   Mirrors some tags from k8s.gcr.io/etcd          0
etcdigital/node                  Node 10 Prepared                                0
ibmcom/etcd-s390x                                                                0
etcdev/fork-geth                                                                 0
anldisr/etcdctl                  Etcdctl                                         0
splazit/etcd-swarm               Etcd cluster in docker swarm                    0                    [OK]
ibmcom/etcd-amd64                                                                0
rancher/etcd-tools                                                               0
razorpay/etcd-backup             Container to take backups for etcd cluster w…   0

这里使用 第一个 bitnami/etcd 来替换 gcr.io/etcd-development/etcd:v3.5.4
安装Etcd的命令(2)

rm -rf /tmp/etcd-data.tmp && mkdir -p /tmp/etcd-data.tmp && \
  docker rmi bitnami/etcd:3.5.4 || true && \
  docker run \
  -p 2379:2379 \
  -p 2380:2380 \
  --mount type=bind,source=/tmp/etcd-data.tmp,destination=/etcd-data \
  --name etcd-bitnami-v3.5.4 \
  bitnami/etcd:3.5.4 \
  /usr/local/bin/etcd \
  --name s1 \
  --data-dir /etcd-data \
  --listen-client-urls http://0.0.0.0:2379 \
  --advertise-client-urls http://0.0.0.0:2379 \
  --listen-peer-urls http://0.0.0.0:2380 \
  --initial-advertise-peer-urls http://0.0.0.0:2380 \
  --initial-cluster s1=http://0.0.0.0:2380 \
  --initial-cluster-token tkn \
  --initial-cluster-state new \
  --log-level info \
  --logger zap \
  --log-outputs stderr

Q2:又报 /opt/bitnami/scripts/etcd/entrypoint.sh: line 26: /usr/local/bin/etcd: No such file or directory ,暂未找到解决办法

etcd 11:49:09.66 Welcome to the Bitnami etcd container
etcd 11:49:09.66 Subscribe to project updates by watching https://github.com/bitnami/bitnami-docker-etcd
etcd 11:49:09.66 Submit issues and feature requests at https://github.com/bitnami/bitnami-docker-etcd/issues

etcd 11:49:09.66
/opt/bitnami/scripts/etcd/entrypoint.sh: line 26: /usr/local/bin/etcd: No such file or directory

Docker安装Etcd通过以上的方式均安装失败,目前尚未找到解决办法,所以目前暂时搁置Docker安装Etcd。

2.4.2 Docker查看etcd版本及使用

docker exec etcd-gcr-v3.5.4 /bin/sh -c "/usr/local/bin/etcd --version"
docker exec etcd-gcr-v3.5.4 /bin/sh -c "/usr/local/bin/etcdctl version"
docker exec etcd-gcr-v3.5.4 /bin/sh -c "/usr/local/bin/etcdctl endpoint health"
docker exec etcd-gcr-v3.5.4 /bin/sh -c "/usr/local/bin/etcdctl put foo bar"
docker exec etcd-gcr-v3.5.4 /bin/sh -c "/usr/local/bin/etcdctl get foo"
docker exec etcd-gcr-v3.5.4 /bin/sh -c "/usr/local/bin/etcdutl version"

你可能感兴趣的:(etcd,etcd)