0% found this document useful (0 votes)
26 views24 pages

DUG01337 MOP Install Docker CIR Linux Rev1.2

This document provides a detailed method of procedure for installing and configuring the Docker Container Image Registry (CIR) server on Linux, including prerequisites, installation steps, and configuration settings. It outlines hardware and software requirements, network port configurations, and firewall rules necessary for successful deployment. The intended audience is personnel responsible for the installation, assuming they have a basic knowledge of Linux OS.

Uploaded by

09941677846
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
26 views24 pages

DUG01337 MOP Install Docker CIR Linux Rev1.2

This document provides a detailed method of procedure for installing and configuring the Docker Container Image Registry (CIR) server on Linux, including prerequisites, installation steps, and configuration settings. It outlines hardware and software requirements, network port configurations, and firewall rules necessary for successful deployment. The intended audience is personnel responsible for the installation, assuming they have a basic knowledge of Linux OS.

Uploaded by

09941677846
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 24

D OC K E R CIR (C ONTA I NER I MAG E

R E G I S TR Y ) S E RVER I NS T AL L A T I ON
A ND C O NFI GU RA T I ON
Method of Procedure
Document Part Number: DUG01337
Document Revision: 1.2
Published: November 2021

© Copyright by Airspan Networks Ltd., 2021. All rights reserved worldwide.


Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

© Copyright by Airspan Networks Ltd., 2021. All rights reserved worldwide.


Legal Notices
The information contained within this document is proprietary, privileged and intended only for the recipient. As such, the
information is subject to all relevant copyright, patent and other laws protecting intellectual property, as well as any specific
agreements protecting Airspan Networks Ltd. rights in the aforesaid information. Neither this document nor the information
contained herein may be published, reproduced, transmitted or disclosed to third parties, in whole or in part, without the
express, prior, written permission of Airspan Networks Ltd. In addition, any use of this document or the information
contained herein for the purposes other than those for which it is disclosed is strictly forbidden.
Airspan Networks Ltd. reserves the right, without prior notice or liability, to make changes in equipment design or
specifications.
Information supplied by Airspan Networks Ltd. is believed in good faith to be accurate and reliable, while every care has been
taken in preparing these documents. However, Airspan Networks Ltd. does not make any representations and gives no
warranties of whatever nature in respect of these documents, including without limitation, the accuracy or completeness of
any information, facts and/or opinions contained therein. No responsibility is assumed by Airspan Networks Ltd. for the use
of the documents nor for the rights of third parties which may be effected in any way by the use thereof. The provision of
these documents (and the documents themselves) does not constitute professional advice of any kind. Any representation(s)
in these documents concerning performance of Airspan Networks Ltd. product(s) are for informational purposes only and
are not warranties of future performance, either expressed or implied. Airspan Networks Ltd., its affiliates, directors,
employees and agents shall not be held liable for any damages or losses, of any nature whatsoever, arising from any use of
and/or reliance on the documents.
These documents may contain flaws, omissions or typesetting errors; no warranty is granted nor liability assumed in relation
thereto unless specifically undertaken in Airspan Networks Ltd. sales contract or order confirmation. Information contained
herein is periodically updated and changes will be incorporated into subsequent editions. If you have encountered an error,
please notify Airspan Networks Ltd.
Product performance figures quoted within this document are indicative and for information purposes only.
UK WEEE Registration number: WEEE/AB0207WZ. For more information, see WEEE Information for Airspan Customers and
Recyclers.

i
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

TABLE OF CONTENTS
Document Information ................................................................................................... 1
Revision History ...................................................................................................................... 1
About This Document ..................................................................................................... 2
1.1 Purpose...................................................................................................................... 2
1.2 Intended Audience .................................................................................................... 2
2 Introduction to Docker CIR ............................................................................................. 3
3 Verifying Docker CIR Prerequisites................................................................................. 4
3.1 Hardware ................................................................................................................... 4
3.2 Software .................................................................................................................... 4
3.3 Network Ports ............................................................................................................ 5
4 Docker Installation .......................................................................................................... 6
4.1 Online Installation...................................................................................................... 6
4.2 Offline Install ............................................................................................................. 6
4.3 Managing Docker Service .......................................................................................... 7
5 Install Docker Compose .................................................................................................. 8
5.1 Online Install .............................................................................................................. 8
5.2 Offline Install ............................................................................................................. 8
6 Configure Firewall Rules on the CIR Server ................................................................... 9
7 Configure HTTPS Access to the Docker CIR Server ...................................................... 10
7.1 Generate a Certificate Authority Certificate ............................................................ 10
7.2 Generating a Server Certificate ............................................................................... 10
7.3 Provide Certificates to Docker ................................................................................. 12
8 Preparing Docker CIR Server ........................................................................................ 13
8.1 Online Installation.................................................................................................... 13
8.2 Offline Installation ................................................................................................... 14
A Migration from Harbor ................................................................................................. 15
B Docker CIR CLI Commands ........................................................................................... 16
Acronyms, Abbreviations, and Definitions .................................................................. 19
Customer Service Help Desk......................................................................................... 20
Airspan Encourages Comments ................................................................................... 20

ii
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

FIGURES
Figure 1: Workflow for Installing CIR on Linux ......................................................................................... 3

TABLES
Table 1. Hardware Configuration - LAB ................................................................................................... 4
Table 2. Hardware Configuration - Commercial ...................................................................................... 4
Table 3. Software Versions ...................................................................................................................... 4
Table 4. Ports........................................................................................................................................... 5
Table 5: Acronyms, Abbreviations, and Definitions ............................................................................... 19

iii
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

Document Information
Revision History
Revision Date Summary of Changes Created by
 Removed ‘$’ from all the commands
 Updated the note in Generate a Certificate Authority Certificate
Rev 1.2 November 2021  Updated Online Installation MVDB, BG
 Updated Offline Installation
 Updated B Docker CIR CLI Commands
Rev 1.1 November 2021  Updated Online Install MVDB, BG

Rev 1.0 October 2021  A new document to create and install Docker CIR on Linux. MVDB, BG

1
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

About This Document


This document details how to install Docker CIR (Container Image Registry) on Linux.

1.1 Purpose
This MOP provides the procedure for installing Docker CIR on Linux.

1.2 Intended Audience


This guide is for the personnel who are responsible for installing Docker CIR on Linux. Airspan assumes
that you are qualified in performing installations and have a basic working knowledge of the Linux OS.

2
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

2 Introduction to Docker CIR


Important
Linux is case sensitive. For commands and user input, use lowercase letters.

The CIR server utilizes Docker as the application.


The expectation of the Docker CIR is to use as a software repository for Airspan full gNodeB nodes
such as: AirStrand2200 and AirSpeed2900.
Figure 1 shows the steps involved in configuring the Docker CIR server and installing the required
software.
Figure 1: Workflow for Installing CIR on Linux

3
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

3 Verifying Docker CIR Prerequisites


This chapter provides information on server resource and software requirements for installing Docker
CIR on Linux.

3.1 Hardware
The following table lists the recommended hardware configurations for deploying Docker CIR in a LAB
environment.

Table 1. Hardware Configuration - LAB

Resource Recommended
CPU 4 CPU/vCPU cores
Memory 8 GB
Disk 100 GB
Network Interface 1 Gbps
The following table lists the recommended hardware configurations for deploying Docker CIR in a
commercial environment.

Table 2. Hardware Configuration - Commercial

Resource Recommended
CPU 12 CPU/vCPU cores
Memory 32 GB
Disk 500 GB
Network Interface 2 Gbps (Interface Bonding/Link Aggregation)

3.2 Software
The following table lists the software versions that must be installed on the target host.

Table 3. Software Versions

Software Version Description

Linux Centos 7.x and 8.x / RHEL 8.x Linux OS

For installation instructions,


Docker Engine Version 17.06.0-ce+ or higher
see Docker Engine Documentation.

For installation instructions, see


Docker Compose Version 1.18.0 or higher
Docker Compose Documentation.

Used to generate certificate and


Openssl Latest is preferred
keys for CIR.

4
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

3.3 Network Ports


CIR requires that the following ports be open on the target host.

Table 4. Ports

Port Protocol Description

CIR portal and core API accepts HTTPS requests on this port. You
443 HTTPS
can change this port in the configuration file.

Used for secure FTP for transfer of Docker images between CIR
22 SFTP
and gNodeB.

5
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

4 Docker Installation
It is recommended to use online installation to receive the latest software required for Docker and
Docker Compose installations. Where online installation is not possible, follow the instructions in this
guide for offline installation.

4.1 Online Installation


You can use your operating system’s package manager to install the latest Docker release. You will
need to add Docker’s repository, update your package lists, and then install Docker.
Execute the following commands to install the required Docker software.

 Replace <Linux-OS> below, with the Linux OS type used for the Docker CIR Server. Either
centos or rhel is accepted.

sudo yum -y install net-tools


sudo yum -y install httpd-tools
sudo yum -y install yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/<Linux-OS>/docker-
ce.repo
sudo yum -y install docker-ce docker-ce-cli containerd.io
sudo groupadd docker
sudo usermod -aG docker $USER

4.2 Offline Install


If the Docker CIR server is not connected to the Internet, manually download the Docker packages and
its prerequisites using an Internet connected PC. Copy the files to the Docker CIR server, example
/home/<user>/downloads directory, extract the .rpm file and manually install.

 Where required, the Docker offline package bundle for the associated CentOS/RHEL
Linux OS and version can be provided.

From the /home/<user>/downloads folder, execute the following commands to install the required
Docker software.

sudo yum -y localinstall *.rpm


sudo groupadd docker
sudo usermod -aG docker $USER

6
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

4.3 Managing Docker Service


You can check whether Docker is running by inspecting its service with systemctl. There are two
components to consider: Docker and Containerd. Docker is the Docker Engine daemon, which the CLI
sends commands to. Containerd is the underlying runtime, which runs your containers.

sudo systemctl status docker.service


sudo systemctl status containerd.service

You can manage the daemons like any other services on your system. Use systemctl stop if you want
to temporarily stop Docker and free up system resources used by your containers. You can restart the
service with systemctl start.

sudo systemctl start docker.service


sudo systemctl stop docker.service

To ensure that the services automatically run at server startup, run the following command.

sudo systemctl enable docker.service

7
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

5 Install Docker Compose


Docker Compose is a separate binary, which is best downloaded directly from the project’s GitHub
releases. Most popular Linux distributions do include Compose in their package managers, but it can
be significantly outdated.
It is recommended to use online installation to receive the latest software required. Where online
installation is not possible, follow the instructions in this section for offline installation.

5.1 Online Install


Execute the following commands to install the required Docker Compose software.

 The version used below was the latest stable release at the time of document creation.

1. This command will download the right binary for your system and drop it into /usr/bin.

curl -L https://github.com/docker/compose/releases/download/1.11.2/docker-
compose-`uname -s`-`uname -m` > ~/docker-compose

2. Apply executable permissions to the binary.

chmod +x ~/docker-compose
sudo mv ~/docker-compose /usr/bin/docker-compose

3. Test the installation.

docker-compose --version

5.2 Offline Install


1. Manually download the latest stable release of Docker Compose for the correct OS from the
following link:
o https://github.com/docker/compose/releases
2. Rename the file to docker-compose, and copy to /usr/bin/ directory of the CIR server.
3. Apply executable permissions to the binary:

sudo chmod +x /usr/bin/docker-compose

4. Verify the Docker Compose version.

docker-compose --version

8
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

6 Configure Firewall Rules on the CIR Server


Execute the following commands to configure firewall rules on the CIR server.

sudo firewall-cmd --permanent --add-service=https


sudo firewall-cmd --permanent --zone=public --add-port=443/tcp
sudo firewall-cmd --permanent --zone=public --add-port=22/tcp
sudo firewall-cmd --reload

9
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

7 Configure HTTPS Access to the Docker CIR Server


7.1 Generate a Certificate Authority Certificate
In a production environment, you should obtain a certificate from a CA. In a test or development
environment, you can generate your own CA. To generate a CA certificate, run the following
commands.

 Replace <hostname.domain-name.com> with the applicable FQDN information in the


sections below.

1. Create the required folders.

mkdir -p ~/{workspace/sslca,registry/{auth,nginx/{conf.d,ssl}}}
sudo mkdir -p /etc/docker/certs.d/<hostname.domain-name.com>/
sudo mkdir -p /usr/share/ca-certificates/extra/

2. Generate a CA server private key.

cd ~/workspace/sslca
openssl genrsa -out ca.key 4096

3. Generate the CA certificate. If you use an FQDN to connect your Docker CIR host, you must
specify it as the CN attribute.
4. Generating self-signed certificates:

openssl req -x509 -new -nodes -sha512 -days 3650 -subj "/CN=<hostname.domain-
name.com>" -key ca.key -out ca.crt

7.2 Generating a Server Certificate


The certificate usually contains a .crt file and a .key file, for example, <hostname.domain-
name.com>.crt and <hostname.domain-name.com>.key.
1. Generate a private key.

openssl genrsa -out <hostname.domain-name.com>.key 4096

2. Generate a CSR. Adapt the values in the -subj option to reflect your organization. If you use
an FQDN to connect your CIR host, you must specify it as the CN attribute and use it in the key
and CSR filenames.
3. Generating the certificate signing request.

openssl req -sha512 -new -subj "/CN=<hostname.domain-name.com>" -key


<hostname.domain-name.com>.key -out <hostname.domain-name.com>.csr

10
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

4. Generate an x509 v3 extension file.


5. Regardless of whether you are using either an FQDN or an IP address to connect to your CIR
host, you must create this file so that you can generate a certificate for your CIR host that
complies with the SAN and x509 v3 extension requirements. Replace the DNS entries to reflect
your domain.

cat > v3.ext <<-EOF


authorityKeyIdentifier=keyid,issuer

basicConstraints=CA:FALSE

keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment

extendedKeyUsage = serverAuth

subjectAltName = @alt_names

[alt_names]

DNS.1=<hostname.domain-name.com>

DNS.2=<hostname>

EOF

6. Use the v3.ext file to generate a certificate for your CIR host.
7. Replace the <hostname.domain-name.com> in the CSR and CRT file names.

openssl x509 -req -sha512 -days 3650 -extfile v3.ext -CA ca.crt -CAkey ca.key -
CAcreateserial -in <hostname.domain-name.com>.csr -out <hostname.domain-
name.com>.crt

8. Convert <hostname.domain-name.com>.crt to <hostname.domain-name.com>.cert, for use


by Docker. The Docker daemon interprets .crt files as CA certificates and .cert files as client
certificates.

openssl x509 -inform PEM -in <hostname.domain-name.com>.crt -out


<hostname.domain-name.com>.cert

11
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

7.3 Provide Certificates to Docker


After generating the ca.crt, < hostname.domain-name.com >.crt, and < hostname.domain-name.com
>.key files, you must provide them to Docker to use them.
1. Copy the server certificate and key into the certificates folder on your CIR host.

cp <hostname.domain-name.com>.key ~/registry/nginx/ssl/
cp <hostname.domain-name.com>.crt ~/registry/nginx/ssl/

2. Copy the server certificate, key, and CA files into the Docker certificates folder on the CIR host.

sudo cp <hostname.domain-name.com>.cert /etc/docker/certs.d/<hostname.domain-


name.com>/
sudo cp <hostname.domain-name.com>.key /etc/docker/certs.d/<hostname.domain-
name.com>/
sudo cp ca.crt /etc/docker/certs.d/<hostname.domain-name.com>/

3. Copy CA file to:

sudo cp ca.crt /usr/share/ca-certificates/extra/

4. Restart Docker.

sudo systemctl restart docker

12
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

8 Preparing Docker CIR Server


It is recommended to use online installation to receive the latest software required. Where online
installation is not possible, follow the instructions in this section for offline installation.

8.1 Online Installation

 For Online Installation, Airspan will provide the required files for this section.

Follow the below steps for online installation.


1. Change the directory.

cd ~/registry

2. Copy the provided online docker-compose.yaml configuration file to the directory in step 1.
3. Change the directory and request a new password file named registry.passwd for your Docker
CIR user (example - admin). Enter a user password and re-type it to confirm.

 Take note of the username and password created for later login to docker.

cd ~/registry/auth && htpasswd -Bc registry.passwd <user>

4. Change the directory.

cd ~/registry/nginx/conf.d

5. Copy the provided online registry.conf Nginx configuration file to the directory in step 4.
6. Edit the registry.conf file, and replace the three references of <hostname.domain-
name.com> with the applicable FQDN information. See example of the three references
below.

server {

listen 443 ssl http2;

server_name <hostname.domain-name.com>;

client_max_body_size 2000M;

ssl_certificate /etc/nginx/ssl/<hostname.domain-name.com>.crt;

ssl_certificate_key /etc/nginx/ssl/<hostname.domain-name.com>.key;

7. Start the Registry.

cd ~/registry/
docker-compose up -d

13
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

8.2 Offline Installation

 For Offline Installation, Airspan will provide the required images and files for this section.

Follow the steps below for offline installation:


1. Change the directory.

cd ~/registry

2. Copy the provided Docker images and the offline docker-compose.yaml configuration file to
the directory in step 1.
3. Execute the commands below to load the images.

docker load -i nms-registry-v1.tar


docker load -i nms-nginx-v1.tar

4. Change the directory and request a new password file named registry.passwd for your Docker
CIR user (example = admin). Enter a user password and re-type it to confirm.

 Take note of the username and password created for later login to docker.

cd ~/registry/auth && htpasswd -Bc registry.passwd <user>

5. Change the directory.

cd ~/registry/nginx/conf.d

6. Copy the provided online registry.conf Nginx configuration file to the directory in step 5.
7. Edit the registry.conf file, and replace the three references of <hostname.domain-
name.com> with the applicable FQDN information. See example of the three references
below.

server {

listen 443 ssl http2;

server_name <hostname.domain-name.com>;

client_max_body_size 2000M;

ssl_certificate /etc/nginx/ssl/<hostname.domain-name.com>.crt;

ssl_certificate_key /etc/nginx/ssl/<hostname.domain-name.com>.key;

8. Start the Registry.

cd ~/registry/
docker-compose up -d

14
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

A Migration from Harbor


Follow the steps below to remove Harbor.
1. Log in to the CIR (Harbor) host and if it is still running, stop and remove the existing Harbor
instance.

cd /your/harbor/installation/files
docker-compose down -v

2. Backup Harbor’s current files so that you can roll back to the current version if necessary.

sudo mv harbor /my_backup_dir/harbor

3. Backup the database, which by default is in the directory /data/database.

sudo cp -r /data/database /my_backup_dir/

4. Create the new required folders.

mkdir -p ~/{workspace/sslca,registry/{auth,nginx/{conf.d,ssl}}}
sudo mkdir -p /usr/share/ca-certificates/extra/

5. Copy the previously created certificate files to their new locations.

cp ca.key ~/workspace/sslca
cp ca.crt ~/workspace/sslca
cp <hostname.domain-name.com>.key ~/workspace/sslca
cp <hostname.domain-name.com>.cert ~/workspace/sslca
cp <hostname.domain-name.com>.crt ~/workspace/sslca
cp <hostname.domain-name.com>.csr ~/workspace/sslca
cp ca.srl ~/workspace/sslca
cp v3.ext ~/workspace/sslca
cp <hostname.domain-name.com>.key ~/registry/nginx/ssl/
cp <hostname.domain-name.com>.crt ~/registry/nginx/ssl/
sudo cp ca.crt /usr/share/ca-certificates/extra/

6. Install the required httpd-tools.

sudo yum -y install httpd-tools

7. Proceed with the steps in Chapter 8.

15
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

B Docker CIR CLI Commands


This section describes various commands that can be used on the CIR CLI after Docker CIR has been
installed.

 All of the tasks listed in this section should be performed using the ACP GUI, therefore
the commands shown are for reference purposes only.

Before running the commands in this section, it is required to login to the Docker CIR using the
following:

docker login <hostname.domain-name.com>

The commands mentioned in this section allow the following:


 Load a gNodeB Docker image to the local docker repository.
 Push a specific gNodeB Docker image from the local Docker repository to the CIR.
 List the available gNodeB Docker images in the CIR.
 View the version of a specific gNodeB Docker image in the CIR.
 Delete a specific gNodeB Docker image from the CIR.
The example commands use the following AIO image file:
 airspan_cucp-docker.tgz

B.1 Load an Image to the Docker Repository


1. Change directory to the path where the image .tgz file is located.
2. Load the image to the local Docker repository:

docker load -i pull airspan_cucp-docker.tgz

3. After the completion of image loading, the following will be displayed:

…..
Loaded image: airspan_cuup_app_x86:airspan_airstrand2200_19.00-31-0.0

o where:
 image name: airspan_cuup_app_x86.
 image tag: airspan_airstrand2200_19.00-31-0.0.
 image version: 19.00-31-0.0.

16
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

B.2 Pushing an Image to CIR


1. Tag the image with the FQDN of the CIR:

docker image tag airspan_cuup_app_x86:airspan_airstrand2200_19.00-31-0.0


<hostname.domain-name.com>/airspan_cuup_app_x86:airspan_airstrand2200_19.00-
31-0.0

2. Push the tagged image to the CIR:

docker push <hostname.domain-


name.com>/airspan_cuup_app_x86:airspan_airstrand2200_19.00-31-0.0

B.3 List CIR Images


To list the available images in the CIR:

curl -k -u <CIR_user>:<CIR_password> https://<hostname.domain-name.com>/v2/_catalog

B.4 View an Image Version


To determine the Repository Project, view in the ACP GUI, Software – Container Image
Repositories – <CIR Name>.
The below example is for CUUP. For the other network functions replace

 airspan_cuup_app_x86 with
airspan_cucp_app_x86
airspan_du_l2s6_x86
airspan_ru
Execute the following to view the list of versions available for specific images in the CIR:

curl -k -u <CIR_user>:<CIR_password> https://<hostname.domain-name.com>/v2/<Repository


Project>/airspan_cuup_app_x86/tags/list

17
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

B.5 Deleting an Image


1. Obtain the hash value of the image manifest by running the garbage collector:

docker exec -it nms-reg-v1 /bin/registry garbage-collect --delete-untagged=true --dry-


run=false /etc/docker/registry/config.yml

2. Copy the ‘marking manifest’ of your image (noting the version), then execute:

curl -kv -u admin:root -X DELETE


https://privatecir.com/v2/airspan_cuup_app_x86/manifests/<sha256:....>

3. Allow a couple of seconds, then run the garbage collector again:

docker exec -it nms-reg-v1 /bin/registry garbage-collect --delete-untagged=true --dry-


run=false /etc/docker/registry/config.yml

 The deletion will only remove the blobs of the image. Image name will still be listed
when querying the CIR catalog (please refer to: List CIR Images).

18
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

Acronyms, Abbreviations, and Definitions


Table 5: Acronyms, Abbreviations, and Definitions

Term Description

ACP Airspan Control Platform


API Application Programming Interface
CA Certification Authority
CIR Container Image Registry
CLI Cross Link Interference
CN Common Name
CPU Central Processing Unit
CSR Certificate Signing Request
DNS Domain Name System
FQDN Fully Qualified Domain Name
HTTP Hypertext Transfer Protocol
HTTPS Hypertext Transfer Protocol Secure
IP Internet Protocol
MOP Method of Procedure
OS Operating System
PC Personal Computer
RHEL Red Hat Enterprise Linux
SAN Storage Area Network
SFTP Secure File Transfer Protocol
SSL Secure Sockets Layer

19
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021
Docker CIR (Container Image Registry) Server Installation and Configuration
Method of Procedure

Customer Service Help Desk


Airspan’s Customer Care Help Desk offers prompt and efficient customer support services.
You must be a registered user and should have a valid support contract. To register, click
https://www.airspan.com/support/, and then select the Register button to complete the Airspan Self
Service Registration form.
Once registered, you will be able to login to create/update issue logs. Alternatively, if you encounter
any problems with logging your issue, send an email to [email protected].
Please include your issue number and Customer Care Helpdesk account details in all communications.

Main Operations Worldwide Headquarters India (Mumbai)


Airspan Communications Ltd. Airspan Networks Inc. Airspan Networks India Pvt Ltd.
Capital Point 777, Yamato Road, Suite 105 Cyber One, 1107/1108,
33 Bath Road Boca Raton, FL 3341-4408, USA S Pranavnandji Marg, Sector - 30,
Slough, Berkshire Tel: +1 561 893 8670 Vashi, Navi Mumbai – 400 703.
SL1 3UF, United Kingdom Tel: +91 22 2087 8003
Tel: +44 1895 467 100

Airspan Encourages Comments


Airspan welcomes any feedback and suggestions that help to improve the quality of the
documentation. Send your feedback to [email protected].

20
© Copyright Airspan Networks Ltd., 2021 P/N: DUG01337 Rev. 1.2, Nov 2021

You might also like