3. ETCD 常用命令
? ? etcdctl是一個命令列的客戶端，它提供了一些命令，可以方便我們在對服務進行測驗或者手動修改資料庫內容，etcdctl與kubectl和systemctl的命令原理及操作類似，其基本用法如下所示：
etcdctl [global options] command [command options] [args...]
具體的命令選項引數可以通過 etcdctl command --help來獲取相關幫助
? ? etcd 在鍵的組織上采用了層次化的空間結構（類似于檔案系統中目錄的概念），資料庫操作圍繞對鍵值和目錄的 CRUD完成生命周期的管理，
? ? 若需要指定集群，可以在~/.bashrc添加以下內容：
HOST_1=127.0.0.1:23791
HOST_2=127.0.0.1:23792
HOST_3=127.0.0.1:23793
ENDPOINTS=${HOST_1},${HOST_2},${HOST_3}
# 如果需要使用原生命令，在命令開頭加一個\ 例如：\etcdctl command
alias etcdctl="etcdctl --endpoints=${ENDPOINTS}"
alias etcdctljson="etcdctl --endpoints=${ENDPOINTS} --write-out=json"
alias etcdctltable="etcdctl --endpoints=${ENDPOINTS} --write-out=table"
? ? 以上添加完成后，source一下使其生效
source ~/.bashrc
3.1 查看etcd版本
etcdctl version
3.2 集群相關操作
3.2.1 指定etcd集群
HOST_1=127.0.0.1
ENDPOINTS=${HOST_1}:2379
etcdctl --endpoints=${ENDPOINTS} member list -w table
3.2.2 查看集群健康狀態
? ? 集群狀態主要是etcdctl endpoint status和etcdctl endpoint health兩條命令
etcdctl --endpoints=${ENDPOINTS} endpoint status -w table
etcdctl --endpoints=${ENDPOINTS} endpoint health -w table
3.2.3 添加成員
? ? 主要用法如下所示：
etcdctl member add <memberName> [options] [flags]
? ? 示例如下所示：
# 示例：將目標節點etcd4添加到集群
etcdctl member add etcd4 http://192.168.3.104:2380
# 啟動目標集群時需要設定啟動引數如下
etcd --name=etcd4 --data-dir=/etcd-data \
--listen-peer-urls=http://192.168.3.104:2380 \
--listen-client-urls=http://192.168.3.104:2379 \
--initial-advertise-peer-urls=http://192.168.3.104:2380 \
--advertise-client-urls=http://192.168.3.104:2379 \
--initial-cluster=etcd1=http://192.168.3.101:2380,etcd2=http://192.168.3.102:2380,etcd3=http://192.168.3.103:2380,etcd4=http://192.168.3.104:2380 \
--initial-cluster-state=existing
3.2.4 更新成員
? ? 主要用法如下所示：
etcdctl member update <memberID> [options] [flags]
? ? 示例如下所示：
etcdctl member update ade526d28b1f92f7 --peer-urls=http://192.168.3.111:2380
3.2.5 洗掉成員
? ? 主要用法如下所示：
etcdctl member remove <memberID> [flags]
? ? 示例如下所示：
etcdctl member remove ade526d28b1f92f7
3.3 資料庫操作命令
3.3.1 put
? ? 添加一個鍵值，基本用法如下所示：
etcdctl put [options] <key> <value> [flags]
? ? 常用引數如下所示：
| 引數 | 功能描述 |
|---|---|
| --prev-kv | 輸出修改前的鍵值 |
? ? 注意事項如下所示：
- 其中value接受從stdin的輸入內容
- 如果value是以橫線-開始，將會被視為flag，如果不希望出現這種情況，可以使用兩個橫線代替--
- 若鍵已經存在，則進行更新并覆寫原有值，若不存在，則進行添加
3.3.2 get
? ? 查詢鍵值，基本用法如下所示：
etcdctl get [options] <key> [range_end] [flags]
? ? 常用引數如下所示：
| 引數 | 功能描述 |
|---|---|
| --hex | 以十六進制形式輸出 |
| --limit number | 設定輸出結果的最大值 |
| --prefix | 根據prefix進行匹配key |
| --order | 對輸出結果進行排序，ASCEND 或 DESCEND |
| --sort-by | 按給定欄位排序，CREATE, KEY, MODIFY, VALUE, VERSION |
| --print-value-only | 僅輸出value值 |
| --from-key | 按byte進行比較，獲取大于等于指定key的結果 |
| --keys-only | 僅獲取keys |
3.3.3 del
? ? 洗掉鍵值，基本用法如下所示：
etcdctl del [options] <key> [range_end] [flags]
? ? 常用引數如下所示：
| 引數 | 功能描述 |
|---|---|
| --prefix | 根據prefix進行匹配洗掉 |
| --prev-kv | 輸出洗掉的鍵值 |
| --from-key | 按byte進行比較，洗掉大于等于指定key的結果 |
3.4 租約相關命令
? ? 租約具有生命周期，需要為租約授予一個TTL(time to live)，將租約系結到一個key上，則key的生命周期與租約一致，可續租，可撤銷租約，其主要用法如下所示：
etcdctl lease <subcommand> [flags]
3.4.1 添加租約
? ? 主要用法如下所示：
etcdctl lease grant <ttl> [flags]
? ? 示例如下所示：
etcdctl lease grant 600
3.4.2 列出租約
? ? 主要用法如下所示：
etcdctl lease list [flags]
? ? 示例如下所示：
etcdctl lease list
3.4.3 洗掉租約
? ? 主要用法如下所示：
etcdctl lease revoke <leaseID> [flags]
? ? 示例如下所示：
etcdctl lease revoke 694d81417acd4754
3.4.4 查看租約詳情
? ? 主要用法如下所示：
etcdctl lease timetolive <leaseID> [options] [flags]
? ? 示例如下所示：
etcdctl lease timetolive 694d81417acd4759
3.4.5 租約續約
? ? 主要用法如下所示：
etcdctl lease keep-alive [options] <leaseID> [flags]
? ? 示例如下所示：
etcdctl lease keep-alive 694d81417acd4757
3.5 watch命令
? ? watch是監聽鍵或前綴發生改變的事件流， 主要用法如下所示：
etcdctl watch [options] [key or prefix] [range_end] [--] [exec-command arg1 arg2 ...] [flags]
? ? 示例如下所示：
# 對某個key監聽操作，當key1發生改變時，會回傳最新值
etcdctl watch name
# 監聽key前綴
etcdctl watch name --prefix
# 監聽到改變后執行相關操作
etcdctl watch name -- etcdctl get age
etcdctl watch name -- etcdctl put name Kevin，如果寫成，會不會變成死回圈，導致無限監視，盡量避免，
3.6 備份和恢復
? ? 主要用于管理節點的快照，其主要用法如下所示：
etcdctl snapshot <subcommand> [flags]
3.6.1 生成快照
? ? 其主要用法如下所示：
etcdctl snapshot save <filename> [flags]
? ? 示例如下所示：
etcdctl snapshot save Surpass.db
3.6.2 查看快照
? ? 其主要用法如下所示：
etcdctl snapshot status <filename> [flags]
? ? 示例如下所示：
etcdctl snapshot status Surpass.db -w table
3.6.3 恢復快照
? ? 其主要用法如下所示：
etcdctl snapshot restore <filename> [options] [flags]
? ? 示例如下所示：
etcdctl snapshot restore Surpass.db \
--name=default \
--data-dir=/home/etcd_db \
--initial-advertise-peer-urls=http://localhost:2380
3.7 查看告警
? ? 如果內部出現問題，會觸發告警，可以通過命令查看告警引起原因，命令如下所示：
etcdctl alarm <subcommand> [flags]
? ? 常用的子命令主要有兩個：
# 查看所有告警
etcdctl alarm list
# 解除所有告警
etcdctl alarm disarm
3.8 用戶權限
? ? etcd默認是沒有開啟訪問控制的，如果開啟外網訪問etcd的話就需要考慮訪問控制的問題，etcd提供了兩種訪問控制的方式：
- 基于身份驗證的訪問控制
- 基于證書的訪問控制
? ? etcd有一個特殊用戶root和一個特殊角色root：
- root用戶：root用戶是etcd的超級管理員，擁有etcd的所有權限，在開啟角色認證之前為們必須要先建立好root用戶
- root角色：具有該root角色的用戶既具有全域讀寫訪問權限，具有更新集群的身份驗證配置的權限，此外，該root角色還授予常規集群維護的特權，包括修改集群成員資格，對存盤進行碎片整理以及拍攝快照，
? ? etcd的權限資源：
- Users: user用來設定身份認證(user:passwd)，一個用戶可以擁有多個角色，每個角色被分配一定的權限(只讀、只寫、可讀寫)，用戶分為root用戶和非root用戶，
- Roles: 角色用來關聯權限，角色主要三類：
?root角色:默認創建root用戶時即創建了root角色，該角色擁有所有權限；
?guest角色:默認自動創建，主要用于非認證使用，普通角色，
?由root用戶創建角色，并分配指定權限， - Permissions: 權限分為只讀、只寫、可讀寫三種權限，權限即對指定目錄或key的讀寫權限，
如果沒有指定任何驗證方式，即未顯示指定以什么用戶進行訪問，那么默認會設定為 guest 角色，默認情況下 guest 也是具有全域訪問權限的
3.8.1 用戶管理
? ? 其主要用法如下所示：
etcdctl user <subcommand> [flags]
? ? 其主要子命令主要如下所示：
| 子命令 | 常用用法 | 功能描述 |
|---|---|---|
| add | etcdctl user add < user name or user:password > [options] [flags] | 添加新用戶 |
| delete | etcdctl user delete < user name > [flags] | 洗掉用戶 |
| list | etcdctl user list [flags] | 列出所有用戶 |
| get | etcdctl user get < user name > [options] [flags] | 獲取用戶詳細資訊 |
| passwd | etcdctl user passwd < user name > [options] [flags] | 修改密碼 |
| grant-role | etcdctl user grant-role < user name > < role name > [flags] | 賦予用戶角色 |
| revoke-role | etcdctl user revoke-role < user name > < role name > [flags] | 洗掉用戶角色 |
3.8.2 角色管理
? ? 其主要用法如下所示：
etcdctl role <subcommand> [flags]
? ? 其主要子命令主要如下所示：
| 子命令 | 常用用法 | 功能描述 |
|---|---|---|
| add | etcdctl role add < role name > [flags] | 添加角色 |
| delete | etcdctl role delete <role name > [flags] | 洗掉角色 |
| list | etcdctl role list [flags] | 列出所有角色 |
| get | etcdctl role get <role name > [flags] | 獲取角色詳情 |
| grant-permission | etcdctl role grant-permission [options] < role name > < permission type > < key > [endkey] [flags] | 把key操作權限授予給一個角色 |
| revoke-permission | etcdctl role revoke-permission < role name > < key > [endkey] [flags] | 從角色中撤銷key操作權限 |
3.8.3 開啟root身份驗證
? ? 在開啟身份驗證后，注意事項如下所示：
- 開啟身份驗證：
所有etcdctl命令操作都需要指定用戶引數--user，引數值為用戶名:密碼
- 開啟證書驗證：
所有etcdctl命令操作都需要添加證書引數--cacert
? ? 開啟root身份驗證的步驟如下所示：
# 添加root 用戶，密碼為surpass
etcdctl user add root:surpass
# 開啟身份驗證，開啟為enable，取消為disable
etcdctl auth enable
# 在開啟身份驗證后，需要帶user相關資訊
etcdctl get name --user=root:surpass
3.8.4 角色授權
? ? 在開啟了root身份驗證后，就可以對普通用戶和角色操作了，
- 1.用戶增刪改查
# 增加普通用戶
etcdctl user add surpass:surpass --user=root:surpass
# 獲取用戶資訊
etcdctl user get surpass --user=root:surpass
# 查看所有用戶
etcdctl user list --user=root:surpass
# 修改用戶密碼
etcdctl user passwd surpass --user=root:surpass
# 洗掉用戶
etcdctl user delete surpass --user=root:surpass
- 2.角色增刪改查
# 添加角色
etcdctl role add etcd-test --user=root:surpass
# 獲取角色詳細資訊
etcdctl role get etcd-test --user=root:surpass
# 獲取所有角色
etcdctl role list --user=root:surpass
# 洗掉角色
etcdctl role delete etcd-test --user=root:surpass
- 3.系結和授權
# 授權角色只讀（read）、只寫(write)和讀寫(readwrite)權限
# 按key進行授權
etcdctl role grant-permission etcd-test readwrite name --user=root:surpass
# 按key的prefix進行授權
etcdctl role grant-permission etcd-test readwrite name --prefix=true --user=root:surpass
# 將授權系結給指定用戶
etcdctl user grant-role test etcd-test --user=root:surpass
# 撤消角色授權
etcdctl role revoke-permission etcd-test name --user=root:surpass
# 撤消系結授權
etcdctl user revoke-role test etcd-test --user=root:surpass
原文地址：https://www.jianshu.com/p/e861a428b90f
本文同步在微信訂閱號上發布，如各位小伙伴們喜歡我的文章，也可以關注我的微信訂閱號：woaitest，或掃描下面的二維碼添加關注：
作者： Surpassme
來源： http://www.jianshu.com/u/28161b7c9995/
http://www.cnblogs.com/surpassme/
宣告：本文著作權歸作者所有，歡迎轉載，但未經作者同意必須保留此段宣告，且在文章頁面明顯位置給出 原文鏈接 ，否則保留追究法律責任的權利，如有問題，可發送郵件 聯系，讓我們尊重原創者著作權，共同營造良好的IT朋友圈，
轉載請註明出處，本文鏈接：https://www.uj5u.com/shujuku/501653.html
標籤：其他
上一篇：centos8安裝mysql
下一篇：0811JDBC隨筆