gemstash 2.2.2 → 2.7.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +61 -17
- data/lib/gemstash/authorization.rb +5 -2
- data/lib/gemstash/cli/authorize.rb +42 -1
- data/lib/gemstash/cli/setup.rb +2 -2
- data/lib/gemstash/cli/start.rb +5 -25
- data/lib/gemstash/cli.rb +6 -2
- data/lib/gemstash/config.ru +0 -2
- data/lib/gemstash/configuration.rb +5 -0
- data/lib/gemstash/db/authorization.rb +3 -3
- data/lib/gemstash/env.rb +0 -11
- data/lib/gemstash/gem_source/upstream_source.rb +15 -0
- data/lib/gemstash/logging.rb +14 -2
- data/lib/gemstash/man/gemstash-authorize.1 +21 -33
- data/lib/gemstash/man/gemstash-authorize.1.txt +20 -16
- data/lib/gemstash/man/gemstash-configuration.5 +61 -119
- data/lib/gemstash/man/gemstash-configuration.5.txt +58 -65
- data/lib/gemstash/man/gemstash-customize.7 +60 -103
- data/lib/gemstash/man/gemstash-customize.7.txt +52 -56
- data/lib/gemstash/man/gemstash-debugging.7 +11 -31
- data/lib/gemstash/man/gemstash-debugging.7.txt +8 -13
- data/lib/gemstash/man/gemstash-deploy.7 +15 -39
- data/lib/gemstash/man/gemstash-deploy.7.txt +18 -22
- data/lib/gemstash/man/gemstash-mirror.7 +10 -31
- data/lib/gemstash/man/gemstash-mirror.7.txt +6 -10
- data/lib/gemstash/man/gemstash-multiple-sources.7 +72 -44
- data/lib/gemstash/man/gemstash-multiple-sources.7.txt +66 -22
- data/lib/gemstash/man/gemstash-private-gems.7 +51 -102
- data/lib/gemstash/man/gemstash-private-gems.7.txt +35 -39
- data/lib/gemstash/man/gemstash-readme.7 +42 -88
- data/lib/gemstash/man/gemstash-readme.7.txt +43 -48
- data/lib/gemstash/man/gemstash-setup.1 +13 -33
- data/lib/gemstash/man/gemstash-setup.1.txt +13 -17
- data/lib/gemstash/man/gemstash-start.1 +5 -29
- data/lib/gemstash/man/gemstash-start.1.txt +6 -14
- data/lib/gemstash/man/gemstash-status.1 +5 -23
- data/lib/gemstash/man/gemstash-status.1.txt +6 -10
- data/lib/gemstash/man/gemstash-stop.1 +5 -23
- data/lib/gemstash/man/gemstash-stop.1.txt +6 -10
- data/lib/gemstash/man/gemstash-version.1 +4 -24
- data/lib/gemstash/man/gemstash-version.1.txt +3 -7
- data/lib/gemstash/migrations/05_authorization_names.rb +10 -0
- data/lib/gemstash/upstream.rb +33 -2
- data/lib/gemstash/version.rb +1 -1
- data/lib/gemstash.rb +1 -0
- metadata +35 -14
@@ -1,29 +1,12 @@
|
|
1
1
|
<!-- Automatically generated by Pandoc -->
|
2
|
-
.\" Automatically generated by Pandoc 3.1
|
2
|
+
.\" Automatically generated by Pandoc 3.1.8
|
3
3
|
.\"
|
4
|
-
.\" Define V font for inline verbatim, using C font in formats
|
5
|
-
.\" that render this, and otherwise B font.
|
6
|
-
.ie "\f[CB]x\f[]"x" \{\
|
7
|
-
. ftr V B
|
8
|
-
. ftr VI BI
|
9
|
-
. ftr VB B
|
10
|
-
. ftr VBI BI
|
11
|
-
.\}
|
12
|
-
.el \{\
|
13
|
-
. ftr V CR
|
14
|
-
. ftr VI CI
|
15
|
-
. ftr VB CB
|
16
|
-
. ftr VBI CBI
|
17
|
-
.\}
|
18
4
|
.TH "gemstash-configuration" "5" "October 13, 2015" "" ""
|
19
|
-
.hy
|
20
5
|
.SH Name
|
21
|
-
.PP
|
22
6
|
gemstash-configuration
|
23
7
|
.SH Synopsis
|
24
8
|
.IP
|
25
|
-
.
|
26
|
-
\f[C]
|
9
|
+
.EX
|
27
10
|
# \[ti]/.gemstash/config.yml
|
28
11
|
---
|
29
12
|
:base_path: \[dq]/var/gemstash\[dq]
|
@@ -41,11 +24,9 @@ gemstash-configuration
|
|
41
24
|
:protected_fetch: true
|
42
25
|
:fetch_timeout: 10
|
43
26
|
:log_file: gemstash.log
|
44
|
-
|
45
|
-
.fi
|
27
|
+
.EE
|
46
28
|
.SH Base Path
|
47
|
-
|
48
|
-
\f[V]:base_path\f[R]
|
29
|
+
\f[CR]:base_path\f[R]
|
49
30
|
.PP
|
50
31
|
Specifies where to store local files like the server log, cached gem
|
51
32
|
files, and the database (when using SQLite).
|
@@ -53,136 +34,111 @@ If the default is being used, the directory will be created if it does
|
|
53
34
|
not exist.
|
54
35
|
Any other directory needs to be created ahead of time and be writable to
|
55
36
|
the Gemstash server process.
|
56
|
-
Specifying the \f[
|
37
|
+
Specifying the \f[CR]:base_path\f[R] via \f[CR]gemstash setup\f[R] will
|
57
38
|
create the directory for you.
|
58
39
|
.SS Default value
|
59
|
-
|
60
|
-
\f[V]\[ti]/.gemstash\f[R]
|
40
|
+
\f[CR]\[ti]/.gemstash\f[R]
|
61
41
|
.SS Valid values
|
62
|
-
.PP
|
63
42
|
Any valid path
|
64
43
|
.SH Cache Type
|
65
|
-
|
66
|
-
\f[V]:cache_type\f[R]
|
44
|
+
\f[CR]:cache_type\f[R]
|
67
45
|
.PP
|
68
46
|
Specifies how to cache values other than gem files (such as gem
|
69
47
|
dependencies).
|
70
|
-
\f[
|
48
|
+
\f[CR]memory\f[R] will use an in memory cache while \f[CR]memcached\f[R]
|
71
49
|
will point to 1 or more Memcached servers.
|
72
|
-
Use the \f[
|
50
|
+
Use the \f[CR]:memcached_servers\f[R] configuration key for specifying
|
73
51
|
where the Memcached server(s) are.
|
74
52
|
.SS Default value
|
75
|
-
|
76
|
-
\f[V]memory\f[R]
|
53
|
+
\f[CR]memory\f[R]
|
77
54
|
.SS Valid values
|
78
|
-
|
79
|
-
\f[V]memory\f[R], \f[V]memcached\f[R]
|
55
|
+
\f[CR]memory\f[R], \f[CR]memcached\f[R]
|
80
56
|
.SH Memcached Servers
|
81
|
-
|
82
|
-
\f[V]:memcached_servers\f[R]
|
57
|
+
\f[CR]:memcached_servers\f[R]
|
83
58
|
.PP
|
84
59
|
Specifies the Memcached servers to connect to when using
|
85
|
-
\f[
|
86
|
-
Only used when \f[
|
60
|
+
\f[CR]memcached\f[R] for the \f[CR]:cache_type\f[R].
|
61
|
+
Only used when \f[CR]memcached\f[R] is used for \f[CR]:cache_type\f[R].
|
87
62
|
.SS Default value
|
88
|
-
|
89
|
-
\f[V]localhost:11211\f[R]
|
63
|
+
\f[CR]localhost:11211\f[R]
|
90
64
|
.SS Valid values
|
91
|
-
.PP
|
92
65
|
A comma delimited list of Memcached servers
|
93
66
|
.SH DB Adapter
|
94
|
-
|
95
|
-
\f[V]:db_adapter\f[R]
|
67
|
+
\f[CR]:db_adapter\f[R]
|
96
68
|
.PP
|
97
69
|
Specifies what database adapter to use.
|
98
|
-
When \f[
|
99
|
-
\f[
|
100
|
-
\f[
|
101
|
-
The database will automatically be created when using
|
102
|
-
|
103
|
-
|
104
|
-
|
70
|
+
When \f[CR]sqlite3\f[R] is used, the database will be located at
|
71
|
+
\f[CR]gemstash.db\f[R] within the directory specified by
|
72
|
+
\f[CR]:base_path\f[R].
|
73
|
+
The database will automatically be created when using
|
74
|
+
\f[CR]sqlite3\f[R].
|
75
|
+
When \f[CR]postgres\f[R], \f[CR]mysql\f[R], or \f[CR]mysql2\f[R] is
|
76
|
+
used, the database to connect to must be specified in the
|
77
|
+
\f[CR]:db_url\f[R] configuration key.
|
105
78
|
The database must already be created when using anything other than
|
106
|
-
\f[
|
79
|
+
\f[CR]sqlite3\f[R].
|
107
80
|
.SS Default value
|
108
|
-
|
109
|
-
\f[V]sqlite3\f[R]
|
81
|
+
\f[CR]sqlite3\f[R]
|
110
82
|
.SS Valid values
|
111
|
-
|
112
|
-
\f[
|
83
|
+
\f[CR]sqlite3\f[R], \f[CR]postgres\f[R], \f[CR]mysql\f[R],
|
84
|
+
\f[CR]mysql2\f[R]
|
113
85
|
.SH DB URL
|
86
|
+
\f[CR]:db_url\f[R]
|
114
87
|
.PP
|
115
|
-
\f[
|
116
|
-
.
|
117
|
-
|
118
|
-
\f[V]mysql\f[R], or \f[V]mysql2\f[R] for the \f[V]:db_adapter\f[R].
|
119
|
-
Only used when the \f[V]:db_adapter\f[R] is not \f[V]sqlite3\f[R].
|
88
|
+
Specifies the database to connect to when using \f[CR]postgres\f[R],
|
89
|
+
\f[CR]mysql\f[R], or \f[CR]mysql2\f[R] for the \f[CR]:db_adapter\f[R].
|
90
|
+
Only used when the \f[CR]:db_adapter\f[R] is not \f[CR]sqlite3\f[R].
|
120
91
|
.SS Default value
|
121
|
-
.PP
|
122
92
|
None
|
123
93
|
.SS Valid values
|
124
|
-
.PP
|
125
94
|
A valid database URL for the Sequel gem (http://sequel.jeremyevans.net/)
|
126
95
|
.SH DB Connection Options
|
96
|
+
\f[CR]:db_connection_options\f[R]
|
127
97
|
.PP
|
128
|
-
\f[
|
129
|
-
.PP
|
130
|
-
Specifies additional \f[V]Sequel.connect\f[R] options to use.
|
98
|
+
Specifies additional \f[CR]Sequel.connect\f[R] options to use.
|
131
99
|
Note that any options here are merged in with the default options, so
|
132
|
-
you need not specify the \f[
|
133
|
-
option.
|
100
|
+
you need not specify the \f[CR]max_connections\f[R] if you customize
|
101
|
+
this option.
|
134
102
|
.SS Default value
|
135
|
-
|
136
|
-
\f[
|
137
|
-
\f[V]{ max_connections: config[:puma_threads] + 1 }\f[R] for any other
|
103
|
+
\f[CR]{ max_connections: 1 }\f[R] for \f[CR]sqlite3\f[R] adapter,
|
104
|
+
\f[CR]{ max_connections: config[:puma_threads] + 1 }\f[R] for any other
|
138
105
|
adapter.
|
139
106
|
.SS Valid values
|
140
|
-
.PP
|
141
107
|
A valid connection options Hash for the
|
142
108
|
Sequel.connect (http://sequel.jeremyevans.net/rdoc/files/doc/opening_databases_rdoc.html#label-General+connection+options)
|
143
109
|
method.
|
144
110
|
.SH Rubygems URL
|
145
|
-
|
146
|
-
\f[V]:rubygems_url\f[R]
|
111
|
+
\f[CR]:rubygems_url\f[R]
|
147
112
|
.PP
|
148
113
|
Specifies the default gem source URL.
|
149
|
-
When any API endpoint is called without a \f[
|
150
|
-
\f[
|
114
|
+
When any API endpoint is called without a \f[CR]/private\f[R] or
|
115
|
+
\f[CR]/upstream/<url>\f[R] prefix, this URL will be used to fetch the
|
151
116
|
result.
|
152
117
|
This value can be safely changed even if there are already gems stashed
|
153
118
|
for the previous value.
|
154
119
|
.SS Default value
|
155
|
-
.
|
156
|
-
\f[V]https://rubygems.org\f[R]
|
120
|
+
\f[CR]https://rubygems.org\f[R]
|
157
121
|
.SS Valid values
|
158
|
-
.PP
|
159
122
|
A valid gem source URL
|
160
123
|
.SH Ignore Gemfile source
|
161
|
-
|
162
|
-
\f[V]:ignore_gemfile_source\f[R]
|
124
|
+
\f[CR]:ignore_gemfile_source\f[R]
|
163
125
|
.PP
|
164
126
|
Ignore the source specified in Gemfile and always use
|
165
|
-
\f[
|
127
|
+
\f[CR]:rubygems_url\f[R] as gems upstream.
|
166
128
|
.SS Default value
|
167
|
-
|
168
|
-
\f[V]false\f[R]
|
129
|
+
\f[CR]false\f[R]
|
169
130
|
.SS Valid values
|
170
|
-
|
171
|
-
Boolean: \f[V]true\f[R] or \f[V]false\f[R]
|
131
|
+
Boolean: \f[CR]true\f[R] or \f[CR]false\f[R]
|
172
132
|
.SH Puma Threads
|
173
|
-
|
174
|
-
\f[V]:puma_threads\f[R]
|
133
|
+
\f[CR]:puma_threads\f[R]
|
175
134
|
.PP
|
176
135
|
Specifies the number of threads used for the Gemstash server.
|
177
136
|
.SS Default value
|
178
|
-
|
179
|
-
\f[V]16\f[R]
|
137
|
+
\f[CR]16\f[R]
|
180
138
|
.SS Valid values
|
181
|
-
|
182
|
-
Integer value with a minimum of \f[V]1\f[R]
|
139
|
+
Integer value with a minimum of \f[CR]1\f[R]
|
183
140
|
.SH Bind Address
|
184
|
-
|
185
|
-
\f[V]:bind\f[R]
|
141
|
+
\f[CR]:bind\f[R]
|
186
142
|
.PP
|
187
143
|
Specifies the binding used to start the Gemstash server.
|
188
144
|
Keep in mind the user starting Gemstash needs to have access to bind in
|
@@ -190,52 +146,38 @@ this manner.
|
|
190
146
|
For example, if you use a port below 1024, you will need to run Gemstash
|
191
147
|
as the root user.
|
192
148
|
.SS Default value
|
193
|
-
.
|
194
|
-
\f[V]tcp://0.0.0.0:9292\f[R]
|
149
|
+
\f[CR]tcp://0.0.0.0:9292\f[R]
|
195
150
|
.SS Valid values
|
196
|
-
.PP
|
197
151
|
Any valid binding that is supported by
|
198
152
|
Puma (https://github.com/puma/puma#binding-tcp--sockets)
|
199
153
|
.SH Protected Fetch
|
200
|
-
|
201
|
-
\f[V]:protected_fetch\f[R]
|
154
|
+
\f[CR]:protected_fetch\f[R]
|
202
155
|
.PP
|
203
156
|
Tells Gemstash to authenticate via an API key before allowing the
|
204
157
|
fetching of private gems and specs.
|
205
158
|
The default behavior is to allow unauthenticated download of private
|
206
159
|
gems and specs.
|
207
160
|
.SS Default value
|
208
|
-
|
209
|
-
\f[V]false\f[R]
|
161
|
+
\f[CR]false\f[R]
|
210
162
|
.SS Valid values
|
211
|
-
|
212
|
-
Boolean values \f[V]true\f[R] or \f[V]false\f[R]
|
163
|
+
Boolean values \f[CR]true\f[R] or \f[CR]false\f[R]
|
213
164
|
.SH Fetch Timeout
|
214
|
-
|
215
|
-
\f[V]:fetch_timeout\f[R]
|
165
|
+
\f[CR]:fetch_timeout\f[R]
|
216
166
|
.PP
|
217
167
|
The timeout setting for fetching gems.
|
218
168
|
Fetching gems over a slow connection may cause timeout errors.
|
219
169
|
If you experience timeout errors, you may want to increase this value.
|
220
|
-
The default is \f[
|
170
|
+
The default is \f[CR]20\f[R] seconds.
|
221
171
|
.SS Default value
|
222
|
-
|
223
|
-
\f[V]20\f[R]
|
172
|
+
\f[CR]20\f[R]
|
224
173
|
.SS Valid values
|
225
|
-
|
226
|
-
Integer value with a minimum of \f[V]1\f[R]
|
174
|
+
Integer value with a minimum of \f[CR]1\f[R]
|
227
175
|
.SH Log File
|
228
|
-
|
229
|
-
\f[V]:log_file\f[R]
|
176
|
+
\f[CR]:log_file\f[R]
|
230
177
|
.PP
|
231
178
|
Indicates the name of the file to use for logging.
|
232
179
|
The file will be placed in the base path.
|
233
180
|
.SS Default value
|
234
|
-
.
|
235
|
-
\f[V]server.log\f[R]
|
181
|
+
\f[CR]server.log\f[R]
|
236
182
|
.SS Valid values
|
237
|
-
|
238
|
-
Any valid file name, or \f[V]:stdout\f[R] to log to \f[V]$stdout\f[R]
|
239
|
-
.PP
|
240
|
-
\f[I]Note: Using \f[VI]:stdout\f[I] for the \f[VI]:log_file\f[I]
|
241
|
-
requires running with \f[VI]--no-daemonize\f[I].\f[R]
|
183
|
+
Any valid file name, or \f[CR]:stdout\f[R] to log to \f[CR]$stdout\f[R]
|
@@ -1,6 +1,4 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
|
1
|
+
4mgemstash-configuration24m(5) 4mgemstash-configuration24m(5)
|
4
2
|
|
5
3
|
<!-- Automatically generated by Pandoc -->
|
6
4
|
|
@@ -27,69 +25,69 @@ gemstash-configuration(5) gemstash-configuration(5)
|
|
27
25
|
:log_file: gemstash.log
|
28
26
|
|
29
27
|
1mBase Path0m
|
30
|
-
|
28
|
+
:base_path
|
31
29
|
|
32
30
|
Specifies where to store local files like the server log, cached gem
|
33
31
|
files, and the database (when using SQLite). If the default is being
|
34
32
|
used, the directory will be created if it does not exist. Any other
|
35
33
|
directory needs to be created ahead of time and be writable to the Gem-
|
36
|
-
stash
|
34
|
+
stash server process. Specifying the :base_path via gemstash setup
|
37
35
|
will create the directory for you.
|
38
36
|
|
39
37
|
1mDefault value0m
|
40
|
-
|
38
|
+
~/.gemstash
|
41
39
|
|
42
40
|
1mValid values0m
|
43
41
|
Any valid path
|
44
42
|
|
45
43
|
1mCache Type0m
|
46
|
-
|
44
|
+
:cache_type
|
47
45
|
|
48
|
-
Specifies
|
49
|
-
dencies).
|
50
|
-
point
|
46
|
+
Specifies how to cache values other than gem files (such as gem depen-
|
47
|
+
dencies). memory will use an in memory cache while memcached will
|
48
|
+
point to 1 or more Memcached servers. Use the :memcached_servers con-
|
51
49
|
figuration key for specifying where the Memcached server(s) are.
|
52
50
|
|
53
51
|
1mDefault value0m
|
54
|
-
|
52
|
+
memory
|
55
53
|
|
56
54
|
1mValid values0m
|
57
|
-
|
55
|
+
memory, memcached
|
58
56
|
|
59
57
|
1mMemcached Servers0m
|
60
|
-
|
58
|
+
:memcached_servers
|
61
59
|
|
62
|
-
Specifies
|
63
|
-
the
|
60
|
+
Specifies the Memcached servers to connect to when using memcached for
|
61
|
+
the :cache_type. Only used when memcached is used for :cache_type.
|
64
62
|
|
65
63
|
1mDefault value0m
|
66
|
-
|
64
|
+
localhost:11211
|
67
65
|
|
68
66
|
1mValid values0m
|
69
67
|
A comma delimited list of Memcached servers
|
70
68
|
|
71
69
|
1mDB Adapter0m
|
72
|
-
|
70
|
+
:db_adapter
|
73
71
|
|
74
|
-
Specifies
|
75
|
-
database
|
76
|
-
by
|
77
|
-
|
78
|
-
nect to must be specified in the
|
79
|
-
base must already be created when using anything other than
|
72
|
+
Specifies what database adapter to use. When sqlite3 is used, the
|
73
|
+
database will be located at gemstash.db within the directory specified
|
74
|
+
by :base_path. The database will automatically be created when using
|
75
|
+
sqlite3. When postgres, mysql, or mysql2 is used, the database to con-
|
76
|
+
nect to must be specified in the :db_url configuration key. The data-
|
77
|
+
base must already be created when using anything other than sqlite3.
|
80
78
|
|
81
79
|
1mDefault value0m
|
82
|
-
|
80
|
+
sqlite3
|
83
81
|
|
84
82
|
1mValid values0m
|
85
|
-
|
83
|
+
sqlite3, postgres, mysql, mysql2
|
86
84
|
|
87
85
|
1mDB URL0m
|
88
|
-
|
86
|
+
:db_url
|
89
87
|
|
90
|
-
Specifies the database to connect to when using
|
91
|
-
|
92
|
-
|
88
|
+
Specifies the database to connect to when using postgres, mysql, or
|
89
|
+
mysql2 for the :db_adapter. Only used when the :db_adapter is not
|
90
|
+
sqlite3.
|
93
91
|
|
94
92
|
1mDefault value0m
|
95
93
|
None
|
@@ -99,15 +97,15 @@ gemstash-configuration(5) gemstash-configuration(5)
|
|
99
97
|
vans.net/)
|
100
98
|
|
101
99
|
1mDB Connection Options0m
|
102
|
-
|
100
|
+
:db_connection_options
|
103
101
|
|
104
|
-
Specifies additional
|
102
|
+
Specifies additional Sequel.connect options to use. Note that any op-
|
105
103
|
tions here are merged in with the default options, so you need not
|
106
|
-
specify the
|
104
|
+
specify the max_connections if you customize this option.
|
107
105
|
|
108
106
|
1mDefault value0m
|
109
|
-
|
110
|
-
|
107
|
+
{ max_connections: 1 } for sqlite3 adapter, { max_connections: con-
|
108
|
+
fig[:puma_threads] + 1 } for any other adapter.
|
111
109
|
|
112
110
|
1mValid values0m
|
113
111
|
A valid connection options Hash for the Sequel.connect (http://se-
|
@@ -115,98 +113,93 @@ gemstash-configuration(5) gemstash-configuration(5)
|
|
115
113
|
General+connection+options) method.
|
116
114
|
|
117
115
|
1mRubygems URL0m
|
118
|
-
|
116
|
+
:rubygems_url
|
119
117
|
|
120
|
-
Specifies
|
121
|
-
without
|
122
|
-
fetch
|
118
|
+
Specifies the default gem source URL. When any API endpoint is called
|
119
|
+
without a /private or /upstream/<url> prefix, this URL will be used to
|
120
|
+
fetch the result. This value can be safely changed even if there are
|
123
121
|
already gems stashed for the previous value.
|
124
122
|
|
125
123
|
1mDefault value0m
|
126
|
-
|
124
|
+
https://rubygems.org
|
127
125
|
|
128
126
|
1mValid values0m
|
129
127
|
A valid gem source URL
|
130
128
|
|
131
129
|
1mIgnore Gemfile source0m
|
132
|
-
|
130
|
+
:ignore_gemfile_source
|
133
131
|
|
134
|
-
Ignore
|
132
|
+
Ignore the source specified in Gemfile and always use :rubygems_url as
|
135
133
|
gems upstream.
|
136
134
|
|
137
135
|
1mDefault value0m
|
138
|
-
|
136
|
+
false
|
139
137
|
|
140
138
|
1mValid values0m
|
141
|
-
Boolean:
|
139
|
+
Boolean: true or false
|
142
140
|
|
143
141
|
1mPuma Threads0m
|
144
|
-
|
142
|
+
:puma_threads
|
145
143
|
|
146
144
|
Specifies the number of threads used for the Gemstash server.
|
147
145
|
|
148
146
|
1mDefault value0m
|
149
|
-
|
147
|
+
16
|
150
148
|
|
151
149
|
1mValid values0m
|
152
|
-
Integer value with a minimum of
|
150
|
+
Integer value with a minimum of 1
|
153
151
|
|
154
152
|
1mBind Address0m
|
155
|
-
|
153
|
+
:bind
|
156
154
|
|
157
|
-
Specifies
|
155
|
+
Specifies the binding used to start the Gemstash server. Keep in mind
|
158
156
|
the user starting Gemstash needs to have access to bind in this manner.
|
159
157
|
For example, if you use a port below 1024, you will need to run Gem-
|
160
158
|
stash as the root user.
|
161
159
|
|
162
160
|
1mDefault value0m
|
163
|
-
|
161
|
+
tcp://0.0.0.0:9292
|
164
162
|
|
165
163
|
1mValid values0m
|
166
164
|
Any valid binding that is supported by Puma
|
167
165
|
(https://github.com/puma/puma#binding-tcp--sockets)
|
168
166
|
|
169
167
|
1mProtected Fetch0m
|
170
|
-
|
168
|
+
:protected_fetch
|
171
169
|
|
172
170
|
Tells Gemstash to authenticate via an API key before allowing the
|
173
171
|
fetching of private gems and specs. The default behavior is to allow
|
174
172
|
unauthenticated download of private gems and specs.
|
175
173
|
|
176
174
|
1mDefault value0m
|
177
|
-
|
175
|
+
false
|
178
176
|
|
179
177
|
1mValid values0m
|
180
|
-
Boolean values
|
178
|
+
Boolean values true or false
|
181
179
|
|
182
180
|
1mFetch Timeout0m
|
183
|
-
|
181
|
+
:fetch_timeout
|
184
182
|
|
185
183
|
The timeout setting for fetching gems. Fetching gems over a slow con-
|
186
184
|
nection may cause timeout errors. If you experience timeout errors,
|
187
|
-
you may want to increase this value. The default is
|
185
|
+
you may want to increase this value. The default is 20 seconds.
|
188
186
|
|
189
187
|
1mDefault value0m
|
190
|
-
|
188
|
+
20
|
191
189
|
|
192
190
|
1mValid values0m
|
193
|
-
Integer value with a minimum of
|
191
|
+
Integer value with a minimum of 1
|
194
192
|
|
195
193
|
1mLog File0m
|
196
|
-
|
194
|
+
:log_file
|
197
195
|
|
198
196
|
Indicates the name of the file to use for logging. The file will be
|
199
197
|
placed in the base path.
|
200
198
|
|
201
199
|
1mDefault value0m
|
202
|
-
|
200
|
+
server.log
|
203
201
|
|
204
202
|
1mValid values0m
|
205
|
-
Any valid file name, or
|
206
|
-
|
207
|
-
4mNote:24m 4mUsing24m 4m1m:stdout24m 4m22mfor24m 4mthe24m 4m1m:log_file24m 4m22mrequires24m 4mrunning24m 4mwith24m 4m1m--no-daemo-0m
|
208
|
-
4m1mnize22m.0m
|
209
|
-
|
210
|
-
|
203
|
+
Any valid file name, or :stdout to log to $stdout
|
211
204
|
|
212
|
-
October 13, 2015
|
205
|
+
October 13, 2015 4mgemstash-configuration24m(5)
|