This document assumes you have deployed Quay Enterprise as a single container.
Quay Enterprise will be configured with a self-signed certificate. A Certificate Authority (CA) is required.
First, create a root CA:
$ openssl genrsa -out rootCA.key 2048 $ openssl req -x509 -new -nodes -key rootCA.key -sha256 -days 1024 -out rootCA.pem
Next, create the key and certificate that will be signed by the CA:
$ openssl genrsa -out ssl.key 2048
When creating the
ssl.csr file it is important that the hostname of the server where QE is installed is used as the
Common Name or QE will reject the configuration. In this demo environment QE is currently installed at
$ openssl req -new -key ssl.key -out ssl.csr ----- Country Name (2 letter code) [XX]:US State or Province Name (full name) :California Locality Name (eg, city) [Default City]:SF Organization Name (eg, company) [Default Company Ltd]:Demo Quay Organizational Unit Name (eg, section) :Demo Quay Common Name (eg, your name or your server's hostname) :reg.example.com Email Address :firstname.lastname@example.org
Sign the certificate with the CA:
$ openssl x509 -req -in ssl.csr -CA rootCA.pem -CAkey rootCA.key -CAcreateserial -out ssl.cert -days 500 -sha256 Signature ok subject=/C=US/ST=California/L=SF/O=Demo Quay/OU=Demo Quay/CN=reg.example.com/emailAddressemail@example.com Getting CA Private Key
The next step can be accomplished either in the QE superuser panel, or from the terminal.
Server Hostname to the appropriate value and check the
Save the configuration. QE will automatically validate the SSL certificate.
Restart the container:
By not using the web interface the configuration checking mechanism built into QE is unavailable. It is suggested to use the web interface if possible.
ssl.cert into the specified
Note: The certificate/key files must be named ssl.key and ssl.cert
$ ls ssl.cert ssl.key $ scp ssl.* firstname.lastname@example.org:/home/core/config/ core@lan-lab-7 ~ $ ls config/ config.yaml ssl.cert ssl.key
PREFERRED_URL_SCHEME: parameter in config.yaml from
Restart the QE container:
$ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES eaf45a4aa12d quay.io/quay/redis "/usr/bin/redis-serve" 22 hours ago Up 22 hours 0.0.0.0:6379->6379/tcp dreamy_ramanujan cbe7b0fa39d8 quay.io/coreos/registry "/sbin/my_init" 22 hours ago Up About an hour 0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp, 8443/tcp fervent_ptolemy 705fe7311940 mysql:5.7 "/entrypoint.sh mysql" 23 hours ago Up 22 hours 0.0.0.0:3306->3306/tcp mysql $ docker restart cbe7b0fa39d8
Confirm the configuration by visiting the URL from a browser:
"Your Connection is not secure" means the CA is not officially and publicly trusted, but confirms that SSL is functioning properly. Check Google for how to configure your operating system and browser to trust a certificate signed by your own CA.
Docker requires that custom certs be installed to
/etc/docker/certs.d/ under a directory with the same name as the hostname private registry. It is also required for the cert to be called
Copying the rootCA file.
$ cp tmp/rootCA.pem /etc/docker/certs.d/reg.example.com/ca.crt`
After this step is completed
docker login should authenticate successfully and pushing to the repository should succeed.
$ sudo docker push reg.example.com/kbrwn/hello The push refers to a repository [reg.example.com/kbrwn/hello] 5f70bf18a086: Layer already exists e493e9cb9dac: Pushed 1770dbc4af14: Pushed a7bb4eb71da7: Pushed 9fad7adcbd46: Pushed 2cec07a74a9f: Pushed f342e0a3e445: Pushed b12f995330bb: Pushed 2016366cdd69: Pushed a930437ab3a5: Pushed 15eb0f73cd14: Pushed latest: digest: sha256:c24be6d92b0a4e2bb8a8cc7c9bd044278d6abdf31534729b1660a485b1cd315c size: 7864