1REGISTRIES(1) May 2017 REGISTRIES(1)
2
3
4
6 registries - parses a TOML configuration file for registries
7
8
9
11 registries [-h|--help] [-i][--input] [-j][--json] [-o][--output]
12 [-V][--variable]
13
14
15
17 registries parses a TOML configuration file about registries and has
18 the ability to output in string or JSON formats. By default,
19 registries will put its output to stdout in string format. The output
20 is primarily for other programs.
21
22
23
25 -h --help Print usage statement
26
27
28 -i --input Allows you to specify a different path and name for a YAML
29 input file. It overrides the default configuration file of
30 /etc/containers/registries.conf.
31
32
33 -j --json Specifies the output be in JSON format. The default is to
34 output as a string.
35
36
37 -o --output Redirects the output from stdout to a file. This option is
38 useful when your program requires its input come from a file (i.e.
39 Systemd Environment files).
40
41
42 -V --variable This option allows you to specify a variable name in the
43 final output. The contents of the variable will also be quoted. It
44 can only be used when writing to an output file. For example, a
45 --variable of REGISTRIES will result in the output format to be like:
46
47
48 REGISTRIES="OUTPUT"
49
50
51
52 This option is useful for putting the contents into a SystemD
53 Environment file for use by a SystemD service.
54
55
56
58 To parse the default file location and obtain a result to stdout in
59 string format:
60
61
62 # registries
63
64
65
66 To parse the default file location and obtain a result to stdout as
67 JSON:
68
69
70 # registries -j
71
72
73
74 To parse the default file location and write the results to a file and
75 insert a variable that can be exported.
76
77
78 # registries -o /tmp/foo -V registries
79
80
81
82 You can also use the -i command line switch to read in a file other
83 than the default input file:
84
85
86 # registries -i /tmp/new_file
87
88
89
90
92 The initial registries.conf files were based on a YAML structure. This
93 version of registries still supports reading YAML. However, you
94 should preferably migrate the YAML to TOML. To do this, make a back up
95 copy of /etc/containers/registries.conf. Then run the
96 registries_migrator tool which will output in the TOML format. Verify
97 the output looks correct and then write it to
98 /etc/containers/registries.conf with the -o switch. For example:
99
100
101 # /usr/libexec/registries_migrator -o /etc/containers/registries.conf
102
103
104
105
106
108 May 2017, Originally compiled by Brent Baude (bbaude at redhat dot com)
109
110
111
112Brent Baude REGISTRIES(1)