1 # ==================================================================================
2 # Copyright (c) 2019-2020 Nokia
3 # Copyright (c) 2018-2020 AT&T Intellectual Property.
5 # Licensed under the Apache License, Version 2.0 (the "License");
6 # you may not use this file except in compliance with the License.
7 # You may obtain a copy of the License at
9 # http://www.apache.org/licenses/LICENSE-2.0
11 # Unless required by applicable law or agreed to in writing, software
12 # distributed under the License is distributed on an "AS IS" BASIS,
13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 # See the License for the specific language governing permissions and
15 # limitations under the License.
16 # ==================================================================================
18 # This builds an image for A1 based on ubuntu. The build takes between three and four
19 # minutes depending on what was previously cached, and results in an image that is
20 # roughly 260 MiB in size (as of May 2021)
23 FROM python:3.8 as build
26 RUN pip install --upgrade pip
28 # pick up things for gevent build
31 RUN apt-get install -y gcc musl-dev make file libffi-dev g++
33 # --- all root operations must be above this line ------------------------------------
36 # create a simple user. This is only really needed in stage 2,
37 # however this makes the copying easier and straighttforward;
38 # the 'pip option --user' command doesn't do the same thing when
41 RUN addgroup a1user && adduser --ingroup a1user a1user
43 # switch to the non-root user for installing python things
46 # Speed hack; we install gevent before anything because when building repeatedly (eg during dev)
47 # and only changing a1 code, we do not need to keep compiling gevent which takes forever
48 RUN pip install --user gevent
49 RUN pip install --user requests
51 COPY setup.py /home/a1user/
52 COPY a1/ /home/a1user/a1
53 RUN pip install --user /home/a1user
57 # ----- stage 2 ---------------------------------------------------------------------------------
59 # It might be tempting to use python:3.8, but that image is more than
60 # 800 GiB to start, and the final image size if it is used is over
61 # 1 GiB!! Using the plain ubuntu image, then installing py3, and taking
62 # things built in the first stage, the final image size isn't tiny, but should
63 # be well under the 800GiB start for the python image.
67 # pick up reference to python so that we can get 3.8 and not the really old default
70 && apt install -y software-properties-common \
71 && add-apt-repository ppa:deadsnakes/ppa \
72 && apt-get install -y python3.8 python3-pip wget \
75 # fetch and install RMR and any other needed libraries
78 ARG RMR_PKG_URL=https://packagecloud.io/o-ran-sc/release/packages/debian/stretch/
80 RUN wget -nv --content-disposition ${RMR_PKG_URL}/rmr_${RMR_VER}_amd64.deb/download.deb
81 RUN wget -nv --content-disposition ${RMR_PKG_URL}/rmr-dev_${RMR_VER}_amd64.deb/download.deb
82 RUN dpkg -i rmr_${RMR_VER}_amd64.deb \
83 && dpkg -i rmr-dev_${RMR_VER}_amd64.deb \
86 # copy python modules; this makes the 2 stage python build work
88 COPY --from=build /home/a1user/.local /home/a1user/.local
90 # create mount point for dir with rmr routing file as named below
92 RUN mkdir -p /opt/route/
94 # create a non-root user, ensure it can access what it needs, and switch to it
97 && adduser --disabled-password --disabled-login --gecos "image-user" --no-create-home --ingroup a1user a1user \
98 && chown -R a1user:a1user /home/a1user/.local \
99 && chown a1user:a1user /home/a1user
102 # ------------------ no root commands after this point -------------------------------------
105 # the maddening onsey-twosey install of pything crud...
107 RUN pip3 install --user connexion
112 ENV LD_LIBRARY_PATH /usr/local/lib/:/usr/local/lib64
113 ENV RMR_SEED_RT /opt/route/local.rt
115 # Set "fake" to True to run standalone
117 ENV USE_FAKE_SDL False
118 ENV PYTHONUNBUFFERED 1
120 # pip installs executable script to $HOME/.local/bin so PATH vars are critical
122 ENV PATH /home/a1user/.local/bin:$PATH
123 ENV PYTHONPATH /home/a1user/.local/lib/python3.8/site-packages
125 # prometheus client gathers data here
127 ENV prometheus_multiproc_dir /tmp
129 # by defalt start the application
131 CMD [ "/usr/bin/python3.8", "/home/a1user/.local/bin/run-a1" ]