Updating an Existing Installation

Development Overview

In general the process is to

  1. Pull the latest images
  2. Pull the latest from diffgram repository (for updates to non-image items like the docker-compose.yaml and install.py) This is git pull if you are in the diffgram local dir.
  3. Restart services

Dev Playground Update

To updates the docker images, e.g. the latest version of Diffgram.

  1. Go to your .env file and change DIFFGRAM_VERSION_TAG to the desired version or latest.

  2. Follow the Docker Commands to Pull The Images

docker-compose pull
docker-compose up -d  # Or remove the -d flag if you want to see logs

Update repo

In some cases there may be changes to the docker-compose file or installer. These changes may not be in the docker images.

git pull
pip install -r requirements.txt

Helm Production Updates

Make sure you have the latest helm chart version by doing

git clone https://github.com/diffgram/diffgram-helm

Then change the diffgramVersion on the values.yaml file to the new version released. And redeploy chart with updated values.

Breaking Changes

Breaking changes tracking.

Production Overview

This is usually automated, e.g. through a github action

  1. Initialize tracking on your preferred deployment tracking pipeline
  2. Migrate the database using the provided almebic migrations
  3. Pull the latest images
  4. Run tests
  5. Migrate traffic

Updating the SDK

pip install diffgram --upgrade

Did this page help you?