Skip to content

Latest commit

 

History

History
186 lines (148 loc) · 6.41 KB

BUILD_IMAGES.md

File metadata and controls

186 lines (148 loc) · 6.41 KB
OpenAirInterface Core Network Docker Deployment : Building the Images

1. Retrieve the proper code version

At the time of writing (2020 / 10 / 27), if you want to use the OpenAir-CN for a Dual Connectivity use case, you need to use proper branches:

cNF Name Branch Name Commit at time of writing Ubuntu18 CentOS7 CentOS8
HSS develop b55a2f24909c05b4f31ef62dacb3c059d5d54990 X X X
MME develop d02307d162da457a6d06e9409c8a5cdc143b1fdb X X X
SPGW-C develop 67a286bf7453b95fdf8deb9b81ae53521825c29b X X
SPGW-U-TINY develop 083899c6047b058f9b5bc9bdee31d235646d73bc X X 
$ git clone https://github.com/OPENAIRINTERFACE/openair-epc-fed.git
$ cd openair-epc-fed
$ git checkout master
$ git pull origin master
$ ./scripts/syncComponents.sh
---------------------------------------------------------
OAI-HSS    component branch : develop
OAI-MME    component branch : develop
OAI-SPGW-C component branch : develop
OAI-SPGW-U component branch : develop
---------------------------------------------------------
....

CAUTION: At the time of writing (2020 / 10 / 26), only HSS and MME have a full CentOS-7 support.

It means that if you are on a CentOS 7 host, you will need to build a CentOS8 image of SPGW-C / SPGW-U-TINY.

CAUTION: if you are using develop branches that are prior to 2020 week 44, please read this page instead.

2. Generic Parameters

Here in our network configuration, we need to pass the "GIT PROXY" configuration.

  • If you do not need, remove the --build-arg EURECOM_PROXY=".." option.
  • If you do need it, change with your proxy value.

CAUTION: the location of the dockerfiles HAVE CHANGED.

3. Build HSS Image

3.1 On a Ubuntu 18.04 Host

$ docker build --target oai-hss --tag oai-hss:production \
               --file component/oai-hss/docker/Dockerfile.ubuntu18.04 \
               --build-arg EURECOM_PROXY="http://proxy.eurecom.fr:8080" component/oai-hss
$ docker image prune --force
$ docker image ls
oai-hss                 production             f478bafd7a06        1 minute ago          341MB
...

3.2 On a CentOS 7 Host

$ docker build --target oai-hss --tag oai-hss:production \
               --file component/oai-hss/docker/Dockerfile.centos7 component/oai-hss
$ docker image prune --force
$ docker image ls
oai-hss                 production             5b277bf98abe        1 minute ago          527MB
...

3.3 On a CentOS 8 Host

$ docker build --target oai-hss --tag oai-hss:production \
               --file component/oai-hss/docker/Dockerfile.centos8 component/oai-hss
$ docker image prune --force
$ docker image ls
oai-hss                 production             5fa77e2b6b94        1 minute ago          517MB
...

4. Build MME Image

4.1 On a Ubuntu 18.04 Host

$ docker build --target oai-mme --tag oai-mme:production \
               --file component/oai-mme/docker/Dockerfile.ubuntu18.04 \
               --build-arg EURECOM_PROXY="http://proxy.eurecom.fr:8080" component/oai-mme
$ docker image prune --force
$ docker image ls
oai-mme                 prodution              45254be9f987        1 minute ago          256MB
...

4.2 On a CentOS 7 Host

$ docker build --target oai-mme --tag oai-mme:production \
               --file component/oai-mme/docker/Dockerfile.centos7 component/oai-mme
$ docker image prune --force
$ docker image ls
oai-mme                 prodution              4133e75b6fc4        1 minute ago          406MB
...

4.3 On a CentOS 8 Host

$ docker build --target oai-mme --tag oai-mme:production \
               --file component/oai-mme/docker/Dockerfile.centos8 component/oai-mme
$ docker image prune --force
$ docker image ls
oai-mme                 prodution              413cec7d8f3b        1 minute ago          412MB
...

5. Build SPGW-C Image

5.1 On a Ubuntu 18.04 Host

$ docker build --target oai-spgwc --tag oai-spgwc:production \
               --file component/oai-spgwc/docker/Dockerfile.ubuntu18.04 \
               --build-arg EURECOM_PROXY="http://proxy.eurecom.fr:8080" component/oai-spgwc
$ docker image prune --force
$ docker image ls
oai-spgwc               production             b1ba7dd16bc5        1 minute ago          218MB
...

5.2 On a CentOS 7/8 Host

Even if we are on a CentOS7 host, we build the SPGW-C image using the CentOS-8 dockerfile.

$ docker build --target oai-spgwc --tag oai-spgwc:production \
               --file component/oai-spgwc/docker/Dockerfile.centos8 component/oai-spgwc
$ docker image prune --force
$ docker image ls
oai-spgwc               production             15ad64676b1f        1 minute ago          379MB
...

6, Build SPGW-U Image

6.1 On a Ubuntu 18.04 Host

$ docker build --target oai-spgwu-tiny --tag oai-spgwu-tiny:production \
               --file component/oai-spgwu-tiny/docker/Dockerfile.ubuntu18.04 \
               --build-arg EURECOM_PROXY="http://proxy.eurecom.fr:8080" component/oai-spgwu-tiny
$ docker image prune --force
$ docker image ls
oai-spgwu-tiny          production             588e14481f2b        1 minute ago          220MB
...

6.2 On a CentOS 7/8 Host

Even if we are on a CentOS7 host, we build the SPGW-U image using the CentOS-8 dockerfile.

$ docker build --target oai-spgwu-tiny --tag oai-spgwu-tiny:production \
               --file component/oai-spgwu-tiny/docker/Dockerfile.centos8 component/oai-spgwu-tiny
$ docker image prune --force
$ docker image ls
oai-spgwu-tiny          production             f2d0a07fba2c        1 minute ago          378MB
...

You are ready to Configure the Containers.