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