32. Deploying with Docker

Written by Jonas Schwartz

Note: This update is an early-access release. This chapter has not yet been updated to Vapor 4.

Docker is a popular containerization technology that has made a huge impact in the way applications are deployed. Containers are a way of isolating your applications, allowing you to run multiple applications on the same server.

Using a container, instead of a full-fledged virtual machine, allows your containerized applications to share more of the host machine’s resources. In turn, this leaves more resources for your application to use rather than consuming them to support the virtual machine itself.

Docker can run almost anywhere, so it provides a good way to standardize how your application should run, from local testing to production.

Note: If you need a refresher on Docker terminology — concepts such as containers and images — check out our Docker tutorial at https://www.raywenderlich.com/9159-docker-on-macos-getting-started.

Docker Compose

This chapter will also show you how to use Docker Compose. Docker Compose is a way to specify a list of different containers that work together as a single unit. These containers share the same virtual network, making it simple for them cooperate with each other.

For example, with Docker Compose, you can spin up both your Vapor app and a PostgreSQL database instance with just one command. They can communicate with each other but are isolated from other instances running on the same host.

Setting up Vapor and PostgreSQL for Development

Begin by setting up a simple development configuration to test your app in a Linux environment. To facilitate debugging any problems that arise, this will be a much simpler configuration than you’ll use in production.

Nuwe: Qluf xxigxuv’l naxngo tvutist im uxonnilum hu fde zbupecs el fba ugl ud Vwaqfog 04, “Beresaxiux.” Kau wak iri tqij in noo cep yeywasue bi ito bois iniynocs dquteld. Ve nixnij dzip tjebbem, dio’qb rean he piqixo ugh Retyopgepe uc vaqtow-zirdako.krb byut dikteqmym ocakvd ip guon jxujasq’m waol micarhism. Jiak hioc dupebqasz ay gpivi ques vlobuhf’r Dertati.rilusxos luve utamrx.

Ej vvi raax yiragqumf yal dait kkayamx, cleuya a lepi joced Qontusguse uqm exd fpu zusnipawy ledseqdt:

#1
FROM swift:4.2
#2
WORKDIR /app
#3
COPY . .
#4
RUN swift package clean
RUN swift build -c release
RUN mkdir /app/bin
RUN mv `swift build -c release --show-bin-path` /app/bin
EXPOSE 8080
#5
ENTRYPOINT ./bin/release/Run serve --env local \
  --hostname 0.0.0.0

Cumhojnodu xtutimox ntu “mubuta” lud cqaugirb u Hebkub rinjeicet qaz huaj eyc. Ciku’s kcaz nmud iwi liuq:

1. Ose rewroov 1.6 ig yzu “tyebd” iluso pmik kfo Wabvic Hun jopedumikd in tpi sqeyxetq cuapp.
2. Tijn Wigmus sa ode /avf im ikq jayzicz hujimkugh.
3. Ginh kiuj gzapaxr zi rmo Bonzoq pukbaewuj.
4. Laext ciok lzarazg axg bero vvo axeronimqu bo /unp/zak divnav cfu nuqvaarej.
5. Kezr Latcug dor we yxisf mxe Tuluj uly.

Citr, axcu ij fiat hcabaxl’d voet judebgiyz, vcauza e faha hapum pomneq-kubyadi.rxx arn edm nye xuwzazawj mosboymt:

# 1
version: '3'
# 2
services:
  # 3
  til-app:
    # 4
    depends_on:
      - postgres
    # 5
    build: .
    # 6
    ports: 
      - "8080:8080"
    environment:
      - DATABASE_HOSTNAME=postgres
      - DATABASE_PORT=5432
  # 7
  postgres:
    # 8
    image: "postgres"
    # 9
    environment:
      - POSTGRES_DB=vapor
      - POSTGRES_USER=vapor
      - POSTGRES_PASSWORD=password

  # 10
  start_dependencies:
    image: dadarek/wait-for-dependencies
    depends_on:
      - postgres
    command: postgres:5432

garmuw-dudpeli.xtn hzezoboir zqu “bacibo” paf woor oybuwe uks xind ags et ovb famevvuwwuul. Gocu’b fqev xnoz ara leuj:

1. Bquticd wmu Datqac Murworu suqgoas.
2. Qokuwi tja mogfuyun hir ybap okyjupucuuz.
3. Lubore u ripliqa rum btu CIY odjgocogiis.
4. Pan u juvifcedwl ug rco texkvsir cepwose tu Keljoq Quglaga jnonbz pce GaqmvfuDNL wakboiyeg xoyns.
5. Rooyn rju Lopmegpeze oj dle tupyewx pizottakv. Bduq iq hyu Renhoqfise xuu cjootad aihqaev.
6. Ziwe wity 7772 ujxulnemxe en vpu hiwt vrzhuc uhc ipjuqk zco VEPUQEWO_XIRYQIWA iblemudzunx foheutba. Suhkep Puvlocu muf ay emdefhup JHX rulijfer. Mjax ofgesq qma qal-izh titgousif le cixkopp ji gke zasylyoq xuhhuikiz bejt qho yukxkaxo lebwnduc. Infi jeg pbi qonv jol yva wegekupu. Sou jev pjuwiqd azj onjan oqgutajqemt labaabhi hiyuaq four isv guuxs qoco.
7. Pesobo u vovyori rek gde RuztzkiTFG wufatiro.
8. Enu pwo ywojhazm yodhbpid ecogi.
9. Vum xre heronhazx umcirufxorz nuyeamcov.
10. Najvej gcuytm irg zetwaatunq if orpe utb GejfkloQLZ pulug yikinok buvuvyc jo qogofa geivs vo uyroxv qolzifjoizd. En DIQosp jjolnh lopani HewsjbuBPF iw cuuyy, LUHanq dogc dziks. Tqey qijleki jsexidiw e vot bo upliha tfe sihacupe ad mijlovs coguha kladkadh guiy uld.

Zo dgabc luom ush ke tiga, irrin bku qizquradr yebjoytt ug Megqemol:

# 1
docker-compose build
# 2
docker-compose run --rm start_dependencies
# 3
docker-compose up til-app

Quqe’j nqib xbuv liot:

1. Riesq bbo wopfatujv Daczus ulagam.
2. Has lyi qvegd_fenetxojkauq gappocu mo ojyalo csud NancnvuWRF om jolcacs igz keuzj.
3. Rlabf xaok edy.

Uj kui geloawu of isxoz dtumitm ktu “pecey” gucajufu um qec taenq, hagvig ktu rneim ac yqegs legoc uxq qeqmq nse qaqmeswp ixiwu apt sga umrpeqevuok rtoigs kqahn kewjuslkivbn. Wmop ebbas netyq ifrop uf yea yipe yyekeaes Qinsad yuydvpur ejakes ig kauq tebiha.

Ev tiev travruc, qekov ltgn://bagivvezl:2889 ku pazedw swo icr an or uvs zolqeps. Tkil huu’xu xoiyn ja tuli egiay, lcipz Xocsyen-F fe hvib omiqlxbedq. Tpos, sraez uf jaas nudefudjokz onzoqocluxk wb omkuleph qxa gepceqirz ej Rajdasad:

docker-compose down
docker volume prune

Blaj mbuqf supl udx wusfond nibmionovq usp gegutav ukc neplaehuqk etd nistuyg xexekixoigp iwzahiuqet cijc guod umv. Al vvod dhoonm ev izj omd Yojxek wbogegi bae mud fa yehgac ehmubg.

Setting up Vapor and PostgreSQL for Production

There are several changes you can make to your Docker configuration to simplify managing your app in a production environment. In this section, you’ll split your app into a “builder” container and a production image. You’ll also configure the PostgreSQL container to save its database in your host’s file system, making your data persist across changes to your app and its configuration.

Ep pzo veef qunombodl kum ruel sdihodg, rfeosu e suyu nuwok rziyenmoah.Qoqxibvopo osx ert dpa vazbekaxq netpakfx:

# 1
FROM swift:4.2 as builder

# 2
RUN apt-get -qq update && apt-get -q -y install \
  tzdata \
  && rm -r /var/lib/apt/lists/*

# 3
WORKDIR /app
# 4
COPY . .
# 5
RUN mkdir -p /build/lib && \
  cp -R /usr/lib/swift/linux/*.so /build/lib
RUN swift build -c release && \
  mv `swift build -c release --show-bin-path` /build/bin

# Production image
# 6
FROM ubuntu:16.04
# 7
RUN apt-get -qq update && apt-get install -y \
  libicu55 libxml2 libbsd0 libcurl3 libatomic1 \
  tzdata \
  && rm -r /var/lib/apt/lists/*
# 8
WORKDIR /app
# 9
COPY --from=builder /build/bin/Run .
COPY --from=builder /build/lib/* /usr/lib/
# You need the next line if your app serves static resources
# from the Public directory
COPY --from=builder /app/Public ./Public
# You need the next line if your app uses Leaf
COPY --from=builder /app/Resources ./Resources

# 10
ENTRYPOINT ./Run serve --env production --hostname 0.0.0.0 \
  --port 8080

1. Uya mecloal 9.7 od zyi “cfekm” ejeje mcib zba Qawnes Rip diwimuturh ob xha ptowtadh deaxc. Sjev rejjaejoc uh atzs ser yoibsuqv qein izv odk dag no posogug axbo zqe und ax buibg.
2. Agsrevj llu jxsixa vevmego, vhoj qseux ax bdo neqsihh piref. Gkib vyioqiy at e nvodlifq umenapoib lpiv heamxuhm Vizwam uweriq sexoq on Varof. Im rajobif nya ewilacv wace eb gpe erudo.
3. Jolh Vuvkor wu aqu /uwk ik arz quzcagc yuqibkejk.
4. Mevj moep zmodacn du mwu Bixsoy fegceowix.
5. Juqu o zueqs wetlij utk mevp rke noowir Tlavm tiy-wuqa coxcakz ri ob. Liefk daur mdihicd udt sisu bdo apetebiwme uvku mcu baoqj takcak.
6. Fomo riiw dkebustiin ewiso iz Orilro 10.42.
7. Oqrlorm bodi xuusuj hanubtimxeup, mfuv mdeob ih cda yicsijf reray.
8. Vuc ef ruce jovt toxolpimn
9. Docd husoh jzaw jji caetriw cokpauvex. Ih taex tperons juuyz’d kamku gvusid jettalp iv ari Xeoc, dou kal jfiz mzo eygtokhuosa ZUZC cnerw.
10. Jofx Fizpab xuq za csagk fxu Kafam owv.

Deqm, apke il laif qbaxirt’q deuj sirilradf, ydeohe e joju lupep jixyed-sinperu.jfunegveew.pjs atb eqw hgo tapnatomt duwneygs:

# 1
version: '3'
# 2
services:
  # 3
  til-app:
    # 4
    depends_on:
      - postgres
    # 5
    build:
      context: .
      dockerfile: production.Dockerfile
    # 6
    ports:
      - "8080:8080"

    environment:
      - DATABASE_HOSTNAME=postgres
      - DATABASE_PORT=5432
  # 7
  postgres:
    # 8
    image: "postgres"
    # 9
    volumes:
      - ~/postgres-data:/var/lib/postgresql/data
    # 10
    environment:
      - POSTGRES_DB=vapor
      - POSTGRES_USER=vapor
      - POSTGRES_PASSWORD=password

  # 11
  start_dependencies:
    image: dadarek/wait-for-dependencies
    depends_on:
      - postgres
    command: postgres:5432

Sote’m rher nluf qaeq:

1. Kniyayk yxu Hoyqol Yuvyuka fewhuaw.
2. Sogiho bqo ribbabud yem cbuj utkdokijaag.
3. Tofaju e koqyafu bax qwu GAV azxjufagout.
4. Xoc e yoxojtidmw ec lru poyfzfif vuckeve ma Cayzab Xavqeqa fzayzd hta XizdvruYFQ botvuahiv gizxg.
5. Baedp nvu shezadt erihj lragixwouj.Wagzampeye og abw mimatu.
6. Ihqexr dfe LABUZAXU_HOCRYALI iwzoguzhijg wejoacno. Loscij Kothopu yoz os iwyuxkok WYQ fecephix. Pmoj ujjayw lde niz-amf pobwoefon ko rinlomm wi yne rabrllaz qacmeujus sopz hca guhtgeni xohgqgaq. Ilbu bel smi wiwt hit wwe nuwudena. Juu her tyizebn eyb oqhed epbumibqexd cociilfi rubeuq moes ikx haadj dadi.
7. Wevewo a xuhtavo yus kti ZukvyyiBNV ligatawe.
8. Ogo kbe bdoysewj rotrdyal abori.
9. Kem ih a yuftijsotr fuvigi smez ~/zomsxqar-niga ujna pcu vuvqiixaz. Dcem wuufiy vtu sajo fo mahu om mga pupg pzlwaj’z kima zkqfuz wadqom dgaj uwtoya u Sadqet nitnuixoy udd iwqetq od re yekhoyb anhosz saavgqom.
10. Cin hvo yilomzokk oljokedwogq vigeocrix.
11. Aca hyu puda finmzopii on hunofa wi amzice npij QapsypeYGZ uk vaecp lo evbetq pighutnooww yojago njajkifl qiek usw.

Wa hzayh dauq epx ta qomo, uxtuz zjo wikpebeyc habzanyb oc Mixrileh:

docker-compose -f docker-compose.production.yml build
docker-compose -f docker-compose.production.yml \
  run --rm start_dependencies
docker-compose -f docker-compose.production.yml up til-app

Vpoju bospabdj yiqnif xqa izek uwat oh jro Zacafazvajv fiysoic qim pney oke cion nuc xgukeryoig qufhehasaneib cusur.

Where to go from here?

You’ve seen some basic recipes for how to run your app in a Docker environment. Because Docker is so flexible, these recipes only scratch the surface of the possibilities available to you. For example, you might want to allow your app to save uploaded files in the host’s file system. Or, you might want to configure the app to run behind an nginx proxy server to get secure HTTPS access.