Docker

From Random Stuff
Jump to navigation Jump to search

Instalare docker

Windows: https://www.docker.com/get-started
Alta distributie: https://docs.docker.com/engine/install/debian/

Note: docker are nevoie de hyper-v, asa ca e posibil sa creeze un conflict cu ceva ce se bazeaza ca acesta sa fie dezactivat(ex. virtualbox) => any thoughts of getting around it are appreciated.

Ganduri zburdalnice pe Linux

Ca sa puteti rulati docker ca si utilizator normal:

 sudo usermod -aG docker ${USER}
 restart / logout

Ca sa porneasca automat:

 sudo systemctl enable docker
 sudo systemctl start docker

Crearea unui container

Pentru crearea unui container ne vom defini un fisier de tip Dockerfile. ex:

FROM debian:stretch-slim

LABEL "description"="Docker image for building and running a generic app"
LABEL "author"="nicolae.natea"

ENV CLEANUP "set -xe && apt-get autoclean && apt-get clean && rm -rf /var/lib/apt/lists/*"

# Cleanup
RUN set -xe && apt-get update && apt-get -y upgrade && ${CLEANUP}

RUN apt-get install -y make build-essential g++ cmake curl gdbserver && ${CLEANUP}

# Setting the command to launch
CMD ["bash", "-l"]

In cadrul fisierului descriem:

  • distributia de la care pornim(ie. debian:stretch-slim)
  • putem seta diverse atribute pt container precum descriere/autor
  • putem defini o variabila pe care sa o reutilizam precum CLEANUP
  • rulam niste comenzi ca si cum am fi in interiorul distributiei(ie. actualizare, instalat toolchain)
  • putem copia un fisier extern in interiorul containerului. ex:
# Add additional files
COPY entrypoint.sh /bin/entrypoint.sh
  • putem schimba permisiuni si seta ca acel fisier sa ruleze la pornirea containerului
RUN chmod +x /bin/entrypoint.sh
ENTRYPOINT ["/bin/entrypoint.sh"]
  • and much more ...

Pt a crea imaginea vom rula comanda

$ docker image build -t nna/generic_builder:latest .
unde nna/generic_builder:latest reprezinta un tag prin care identificam imaginea
se presupune ca fisierul cu denumirea Dockerfile se afla in directorul curent. altfel poate fi specificat adaugand: -f "<cale>/Dockerfile"

Daca totul decurge ok, putem verifica cum ca imaginea a fost creata ok ruland comanda:

$ docker images
REPOSITORY            TAG                 IMAGE ID            CREATED             SIZE
nna/generic_builder   latest              963fd255c1fd        4 hours ago         391MB

Pornirea unui container poate fi facuta folosind comanda:

$ docker run -i -t nna/generic_builder

Parametrii aditionali mai interesanti ce pot fi pasati comenzii run:

  • -h, --hostname string Container host name
  • -v, --volume list Bind mount a volume
  • -w, --workdir string Working directory inside the container
  • -e, --env list Set environment variables
  • etc... docker run --help

ie. docker run -i -h builder -e USER_NAME=${USER} -e USER_ID=`id -u ${USER}` -v ${PWD}:${PWD} -w ${PWD} -t nna/generic_builder

-v ${PWD}:${PWD} -> mapam directorul curent la directorul cu acelasi nume din cadrul containerului
-w ${PWD} -> setam calea curenta ca si cale de start in interiorul containerului
-e USER_NAME=${USER} -> setam o variabila de sistem USER_NAME in interiorul containerului cu valoarea userului curent
-h=builder -> setam ca hostul sa fie builder

Dupa ce rulati comanda de mai sus veti vedea ca sunteti logati ca si root. un lucru pe care l-am putea face prin entrypoint.sh, ar fi sa folosim valoarile primite prin variabile de sistem pt a schimba utilizatorul curent (groupadd / useradd / su). etc.

Note: putem sa ne facem containerul public pe docker hub, daca ne creem un utilizator. Pentru aceasta am folosi comanda: docker push <nume imagine>

Utilizarea unui container existent (gitlab-ce)

Putem folosi un container existent pe care sa il downloadam dintr-un repository privat sau cel public.

Am putea sa ne aducem o imagine local(ex. versiunea comunity pentru gitlab) folosind comanda:

docker pull gitlab/gitlab-ce:latest

Cu toate astea, e adusa automat local daca nu exista atunci cand rulam comanda cu run:

docker run --detach \
  --hostname localhost \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume $HOME/gitlab/config:/etc/gitlab \
  --volume $HOME/gitlab/logs:/var/log/gitlab \
  --volume $HOME/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

In comanda de mai sus pornim un server de gitlab comunity edition:

  • --detach => containerul va rula in background
  • --publish <local port>:<container port> => mapam portul din container la portul local.
  • --restart always => in cazul in care moare containerul, vrem sa reporneasca automat
  • --volume <cai> => mapeaza niste cai permanente unde vor fi tinute configuratiile si proiectele
  • --name gitlab => un nume atribuit containerului. vizibil daca dati comanda: docker container list

Gitlab nu porneste incredibil de rapid mai ales prima oara, asa ca putem sa ne atasam sa urmarim logurile folosind comanda:

docker logs -f gitlab

Dupa vre-un minut/doua putem sa accesam din browser: http://localhost (port 80), https://localhost (port 443), iar 22 e portul pt ssh folosit pentru git

Further steps

Atasez la un container ce ruleaza: docker attach ...
Salvarea starii curente a unui container intr-o imagine noua docker commit ...
Listare imagini: docker image list
Stergere imagine: docker image rm ...
Listare container ce ruleaza: docker container list
Restart container: docker restart ...
Oprire fortata container: docker kill ...
etc. foarte stufos

Comanda docker --help e foarte utila.
Deasemenea putem da ca si parametrii help si pt subcomenzi: ex. docker run --help

Integrare cu eclipse

Instalam eclipse CDT: https://www.eclipse.org/downloads/

Ideal ar fi sa ne instalam cateva extensii in cadrul eclipse din: Help -> Install new software

  • Docker Tooling
  • C/C++ Docker Launch....

Eclipse dependencies.gif

Dupa asta putem crea un proiect nou:

File -> New -> Other -> C++ Project -> Makefile Project -> Hello world -> ....

Configuram proiectul pentru a folosi containerul anterior creat

Click dreapta pe proiectul creat: Properties -> C/C++ Build -> Settings -> Container Settings -> Bifam "build inside docker image"
Aditional putem indica niste directoare pe care ni le dorim mapate
Apply

Si suntem pregatiti pentru a compila si rula aplicatia in interiorul containerului
Note: Pentru debug se presupune ca aveti gdb pe host(ar trebui sa fie daca ati adaugat caile catre MinGW si l-ati bifat cand ati instalat)

Eclipse new project.gif