Avatars is a small sample project for Docker demonstration purposes.
It consists of a Python web API backend to generate avatars and a Javascript SPA (single page app) frontend. If you are not a Python or Javascript guru, don't panic!
To get started, clone this repository locally:
git clone https://github.com/dockersamples/avatars.gitAll subsequent commands assume they are run from the root repository directory
(i.e. avatars/ folder).
Run make help to see a list of available targets.
You'll need to first install Tilt and prerequisites (Docker + development Kubernetes cluster).
Run tilt up or make tilt.
All resources will be deployed to the namespace and cluster as determined by the active Kubernetes config context.
- Tilt web interface: http://localhost:10350/
- Avatars frontend: http://localhost:5735/
- Avatars API:
curl http://localhost:5734/api/avatar/spec
Run make compose.
- Avatars frontend: http://localhost:5735/
Compose launches the services and attaches in file watch mode.
Run docker compose -p avatars logs -f from a separate terminal to stream logs.
ℹ️ If you haven't already, open the Docker Desktop dashboard and enable Kubernetes from
Settings > Kubernetes > ☑️ Enable Kubernetesand apply.
Run make kubernetes.
All resources will be deployed to the avatars namespace in the docker-desktop Kubernetes cluster.
- Avatars frontend: http://localhost:5735/
Buildx builds images and Kubernetes creates Deployments and Services.
The images are not pushed to a registry, as Docker Desktop's Kubernetes
integration runs the images directly from the Docker Engine image store using
cri-dockerd (formerly known as dockershim).
Run `kubectl --context=docker-desktop --namespace=avatars logs -l='app.kubernetes.io/part-of=dockersamples_avatars' from a separate terminal to stream logs.
git clone https://github.com/dockersamples/avatars
cd avatars
docker compose up -d
docker compose watch
docker compose alpha viz