forked from cockroachdb/cockroach
-
Notifications
You must be signed in to change notification settings - Fork 0
/
zone.go
152 lines (136 loc) · 4.53 KB
/
zone.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
// Copyright 2014 The Cockroach Authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
// implied. See the License for the specific language governing
// permissions and limitations under the License. See the AUTHORS file
// for names of contributors.
//
// Author: Spencer Kimball (spencer.kimball@gmail.com)
// Author: Bram Gruneir (bram.gruneir@gmail.com)
package cli
import (
"flag"
commander "code.google.com/p/go-commander"
"github.com/cockroachdb/cockroach/server"
)
// A CmdGetZone command displays the zone config for the specified
// prefix.
var CmdGetZone = &commander.Command{
UsageLine: "get-zone [options] <key-prefix>",
Short: "fetches and displays the zone config",
Long: `
Fetches and displays the zone configuration for <key-prefix>. The key
prefix should be escaped via URL query escaping if it contains
non-ascii bytes or spaces.
`,
Run: runGetZone,
Flag: *flag.CommandLine,
}
// runGetZone invokes the REST API with GET action and key prefix as path.
func runGetZone(cmd *commander.Command, args []string) {
if len(args) != 1 {
cmd.Usage()
return
}
server.RunGetZone(Context, args[0])
}
// A CmdLsZones command displays a list of zone configs by prefix.
var CmdLsZones = &commander.Command{
UsageLine: "ls-zones [options] [key-regexp]",
Short: "list all zone configs by key prefix",
Long: `
List zone configs. If a regular expression is given, the results of
the listing are filtered by key prefixes matching the regexp. The key
prefix should be escaped via URL query escaping if it contains
non-ascii bytes or spaces.
`,
Run: runLsZones,
Flag: *flag.CommandLine,
}
// runLsZones invokes the REST API with GET action and no path, which
// fetches a list of all zone configuration prefixes. The optional
// regexp is applied to the complete list and matching prefixes
// displayed.
func runLsZones(cmd *commander.Command, args []string) {
if len(args) > 1 {
cmd.Usage()
return
}
pattern := ""
if len(args) == 1 {
pattern = args[0]
}
server.RunLsZone(Context, pattern)
}
// A CmdRmZone command removes a zone config by prefix.
var CmdRmZone = &commander.Command{
UsageLine: "rm-zone [options] <key-prefix>",
Short: "remove a zone config by key prefix",
Long: `
Remove an existing zone config by key prefix. No action is taken if no
zone configuration exists for the specified key prefix. Note that this
command can affect only a single zone config with an exactly matching
prefix. The key prefix should be escaped via URL query escaping if it
contains non-ascii bytes or spaces.
`,
Run: runRmZone,
Flag: *flag.CommandLine,
}
// runRmZone invokes the REST API with DELETE action and key prefix as
// path.
func runRmZone(cmd *commander.Command, args []string) {
if len(args) != 1 {
cmd.Usage()
return
}
server.RunRmZone(Context, args[0])
}
// A CmdSetZone command creates a new or updates an existing zone
// config.
var CmdSetZone = &commander.Command{
UsageLine: "set-zone [options] <key-prefix> <zone-config-file>",
Short: "create or update zone config for key prefix",
Long: `
Create or update a zone config for the specified key prefix (first
argument: <key-prefix>) to the contents of the specified file
(second argument: <zone-config-file>). The key prefix should be
escaped via URL query escaping if it contains non-ascii bytes or
spaces.
The zone config format has the following YAML schema:
replicas:
- [comma-separated attribute list]
- ...
range_min_bytes: <size-in-bytes>
range_max_bytes: <size-in-bytes>
For example:
replicas:
- [us-east-1a, ssd]
- [us-east-1b, ssd]
- [us-west-1b, ssd]
range_min_bytes: 8388608
range_min_bytes: 67108864
Setting zone configs will guarantee that key ranges will be split
such that no key range straddles two zone config specifications.
This feature can be taken advantage of to pre-split ranges.
`,
Run: runSetZone,
Flag: *flag.CommandLine,
}
// runSetZone invokes the REST API with POST action and key prefix as
// path. The specified configuration file is read from disk and sent
// as the POST body.
func runSetZone(cmd *commander.Command, args []string) {
if len(args) != 2 {
cmd.Usage()
return
}
server.RunSetZone(Context, args[0], args[1])
}