This guide details the procedure for updating your existing deployment of IC Observability Stack to the latest version. Since the stack is provisioned using Docker, the upgrade process is generally safe, as all of the resources coming from this repository are codified and don't conflict with each other.
Disclaimer: If you make your changes, either in Grafana using the UI or changes in the code there may be conflicts. More about resolving conflicts here.
Before starting the upgrade, ensure your system is ready:
- Clean Working Directory: Ensure you have commited or stashed any local changes to the repository before pulling updates. To see if that is needed conslut the panel showing the State of the directory or run the command:
git status
# If there are any changes you can pick to commit or stash them.- Turn off the stack:
docker compose downNavigate to the root directory (where this file is located) and fetch the latest code from the upstream branch:
git pull origin masterThis command will fetch and merge any new Dockerfiles, configuration files, or any other dependency updates int your local working copy.
After every upgrade run the setup.sh to ensure that your environment is configured to work with the latest version of the stack properly. Navigate to the root directory (where this file is located) and run setup like the following:
./setup.shNow that you have the newest version locally you can run the following command to bring the services back up:
# This will create the docker containers.
docker compose up -dAfter the services are back up you should:
- Check that victoria metrics can scrape targets
- Check that you can access grafana
- Check if there are any services that aren't running:
docker compose ps --format json | jq 'select(.State != "running") | {name: .Name, status: .Status, exitCode: .ExitCode}'