Add registries.conf man page
This commit is contained in:
parent
e1b681e6bb
commit
b657706254
41
registries.conf.5.md
Normal file
41
registries.conf.5.md
Normal file
@ -0,0 +1,41 @@
|
|||||||
|
% registries.conf(5) System-wide registry configuration file
|
||||||
|
% Brent Baude
|
||||||
|
% Aug 2017
|
||||||
|
|
||||||
|
# NAME
|
||||||
|
registries.conf - Syntax of System Registry Configuration File
|
||||||
|
|
||||||
|
# DESCRIPTION
|
||||||
|
The REGISTRIES configuration file is a system-wide configuration file for container image
|
||||||
|
registries. The file format is TOML.
|
||||||
|
|
||||||
|
# FORMAT
|
||||||
|
The TOML_format is used to build simple list format for registries under two
|
||||||
|
categories: `search` and `insecure`. You can list multiple registries using
|
||||||
|
as a comma separated list.
|
||||||
|
|
||||||
|
Search registries are used when the caller of a container runtime does not fully specify the
|
||||||
|
container image that they want to execute. These registries are prepended onto the front
|
||||||
|
of the specified container image until the named image is found at a registry.
|
||||||
|
|
||||||
|
Insecure Registries. By default container runtimes use TLS when retrieving images
|
||||||
|
from a registry. If the registry is not setup with TLS, then the container runtime
|
||||||
|
will fail to pull images from the registry. If you add the registry to the list of
|
||||||
|
insecure registries then the container runtime will attempt use standard web protocols to
|
||||||
|
pull the image. It also allows you to pull from a registry with self-signed certificates.
|
||||||
|
Note insecure registries can be used for any registry, not just the
|
||||||
|
registries listed under search.
|
||||||
|
|
||||||
|
The following example configuration defines two searchable registries and one
|
||||||
|
insecure registry.
|
||||||
|
|
||||||
|
```
|
||||||
|
[registries.search]
|
||||||
|
registries = ["registry1.com", "registry2.com"]
|
||||||
|
|
||||||
|
[registries.insecure]
|
||||||
|
registries = ["registry3.com"]
|
||||||
|
```
|
||||||
|
|
||||||
|
# HISTORY
|
||||||
|
Aug 2017, Originally compiled by Brent Baude <bbaude@redhat.com>
|
@ -38,7 +38,7 @@ Name: %{repo}
|
|||||||
Epoch: 1
|
Epoch: 1
|
||||||
%endif # centos
|
%endif # centos
|
||||||
Version: 0.1.29
|
Version: 0.1.29
|
||||||
Release: 1.git%{shortcommit0}%{?dist}
|
Release: 2.git%{shortcommit0}%{?dist}
|
||||||
Summary: Inspect Docker images and repositories on registries
|
Summary: Inspect Docker images and repositories on registries
|
||||||
License: ASL 2.0
|
License: ASL 2.0
|
||||||
URL: %{git0}
|
URL: %{git0}
|
||||||
@ -46,6 +46,7 @@ Source0: %{git0}/archive/%{commit0}/%{name}-%{shortcommit0}.tar.gz
|
|||||||
Source1: storage.conf
|
Source1: storage.conf
|
||||||
Source2: containers-storage.conf.5.md
|
Source2: containers-storage.conf.5.md
|
||||||
Source3: mounts.conf
|
Source3: mounts.conf
|
||||||
|
Source4: registries.conf.5.md
|
||||||
|
|
||||||
%if 0%{?fedora}
|
%if 0%{?fedora}
|
||||||
BuildRequires: go-srpm-macros
|
BuildRequires: go-srpm-macros
|
||||||
@ -215,6 +216,7 @@ mkdir -p %{buildroot}%{_sysconfdir}
|
|||||||
install -m0644 %{SOURCE1} %{buildroot}%{_sysconfdir}/containers/storage.conf
|
install -m0644 %{SOURCE1} %{buildroot}%{_sysconfdir}/containers/storage.conf
|
||||||
mkdir -p %{buildroot}%{_mandir}/man5
|
mkdir -p %{buildroot}%{_mandir}/man5
|
||||||
go-md2man -in %{SOURCE2} -out %{buildroot}%{_mandir}/man5/containers-storage.conf.5
|
go-md2man -in %{SOURCE2} -out %{buildroot}%{_mandir}/man5/containers-storage.conf.5
|
||||||
|
go-md2man -in %{SOURCE4} -out %{buildroot}%{_mandir}/man5/registries.conf.5
|
||||||
mkdir -p %{buildroot}%{_datadir}/containers
|
mkdir -p %{buildroot}%{_datadir}/containers
|
||||||
install -m0644 %{SOURCE3} %{buildroot}%{_datadir}/containers/mounts.conf
|
install -m0644 %{SOURCE3} %{buildroot}%{_datadir}/containers/mounts.conf
|
||||||
|
|
||||||
@ -288,7 +290,7 @@ export GOPATH=%{buildroot}/%{gopath}:$(pwd)/vendor:%{gopath}
|
|||||||
%config(noreplace) %{_sysconfdir}/containers/registries.d/default.yaml
|
%config(noreplace) %{_sysconfdir}/containers/registries.d/default.yaml
|
||||||
%config(noreplace) %{_sysconfdir}/containers/storage.conf
|
%config(noreplace) %{_sysconfdir}/containers/storage.conf
|
||||||
%dir %{_sharedstatedir}/atomic/sigstore
|
%dir %{_sharedstatedir}/atomic/sigstore
|
||||||
%{_mandir}/man5/containers-storage.conf.5*
|
%{_mandir}/man5/*
|
||||||
%dir %{_datadir}/containers
|
%dir %{_datadir}/containers
|
||||||
%{_datadir}/containers/mounts.conf
|
%{_datadir}/containers/mounts.conf
|
||||||
%dir %{_datadir}/rhel/secrets
|
%dir %{_datadir}/rhel/secrets
|
||||||
@ -306,6 +308,9 @@ export GOPATH=%{buildroot}/%{gopath}:$(pwd)/vendor:%{gopath}
|
|||||||
%{_datadir}/bash-completion/completions/%{name}
|
%{_datadir}/bash-completion/completions/%{name}
|
||||||
|
|
||||||
%changelog
|
%changelog
|
||||||
|
* Mon Apr 2 2018 dwalsh <dwalsh@redhat.com> - 0.1.29-2.git
|
||||||
|
- Add registries.conf man page
|
||||||
|
|
||||||
* Thu Mar 29 2018 dwalsh <dwalsh@redhat.com> - 0.1.29-1.git
|
* Thu Mar 29 2018 dwalsh <dwalsh@redhat.com> - 0.1.29-1.git
|
||||||
- bump to 0.1.29-1
|
- bump to 0.1.29-1
|
||||||
- Updated containers/image
|
- Updated containers/image
|
||||||
|
Loading…
Reference in New Issue
Block a user