Deploying on Docker
For other deployment options, see Deploying Conduit Applications.

Purpose

This document will describe the steps to deploy a Conduit application through Docker, Docker Compose or a container orchestration platform like Kubernetes. For Dockerfile and Kubernetes templates, see this repository.
If you are unfamiliar with deploying applications in this way, this is not a good beginner's guide and will not cover the topics of Docker, Docker Compose or Kubernetes.

Dockerfiles

The following Dockerfile will run a Conduit application.
FROM google/dart
WORKDIR /app
ADD pubspec.* /app/
RUN pub get --no-precompile
ADD . /app/
RUN pub get --offline --no-precompile
WORKDIR /app
EXPOSE 80
ENTRYPOINT ["pub", "run", "conduit:conduit", "serve", "--port", "80"]

Docker Compose

To deploy your application (which uses the Conduit ORM) using Docker Compose, use this template:
Dockerfile
Use the Dockerfile specified above.
docker-compose.yml
version: '3'
services:
my-app:
build: .
ports:
- "80:80"
db:
image: "postgres:11"
container_name: "postgres_database"
environment:
- POSTGRES_PASSWORD=password-from-config-yaml
- POSTGRES_USER=user-from-config-yaml
- POSTGRES_DB=db-from-config-yaml
ports:
- "65432:port-from-config-yaml" # If you want to expose the db from the container
volumes:
- db_data:/var/lib/postgresql/data
volumes:
db_data: {}
Once the service is up (using docker-compose up -d), you can run your database migrations using
conduit db upgrade --connect postgres://user-from-config-yaml:[email protected]:65432/db-from-config-yaml

Kubernetes Objects

For more Kubernetes objects - including tasks for database migrations and OAuth 2.0 client management - see this repository. The following is Kubernetes configuration file for starting a Conduit application and exposing it as a service. Replace <APP_NAME> with your application's name.
apiVersion: v1
kind: Service
metadata:
name: api-service
namespace: <APP_NAME>
spec:
selector:
app: <APP_NAME>
role: backend
type: api
ports:
- port: 80
targetPort: 8082
---
apiVersion: apps/v1beta1
kind: Deployment
metadata:
name: api-deployment
namespace: <APP_NAME>
spec:
replicas: 2
template:
metadata:
labels:
app: <APP_NAME>
role: backend
type: api
spec:
containers:
- name: <APP_NAME>
# In development, setting `imagePullPolicy: Always` and using :latest tag is useful.
# imagePullPolicy: Always
image: <IMAGE>
envFrom:
- secretRef:
name: secrets
- configMapRef:
name: config
ports:
- containerPort: 8082
securityContext:
runAsNonRoot: true
Copy link
On this page
Purpose
Dockerfiles
Docker Compose
Kubernetes Objects