Require git >= 2.49 on managed machines

changelog/0097-min-git-version.yml

@@ -0,0 +1,34 @@
+title: Set minimum git version to 2.49
+key: min-git-version
+date: 2026-05-05
+optional_per_env: no
+# (optional) Min version of HQ that MUST be deployed before this change can be rolled out (commit hash)
+min_commcare_version:
+# (optional) Max version of HQ that can be deployed before this change MUST be rolled out (commit hash)
+max_commcare_version:
+context: |
+  commcare-cloud now requires git 2.49 or later on all machines that install git
+  via the `git` ansible role (control machines and any other host that runs git
+  for commcare-cloud purposes).
+
+details: |
+  Pinning a minimum git version lets us rely on features from recent git
+  releases without having to first check what's installed on each machine.
+  The `ppa:git-core/ppa` repository (already configured by this role) ships
+  versions well past 2.49 for all supported Ubuntu releases, so the upgrade
+  is just a matter of running the install_git tag.
+
+update_steps: |
+  Update git on all machines in your environment:
+
+  ```bash
+  cchq <env> deploy-stack --tags=install_git
+  ```
+
+  Then verify:
+
+  ```bash
+  cchq <env> run-shell-command all 'git --version'
+  ```
+
+  Output should show `git version 2.49.x` or later on every host.

docs/source/changelog/0097-min-git-version.md

@@ -0,0 +1,39 @@
+<!--THIS FILE IS AUTOGENERATED: DO NOT EDIT-->
+<!--See https://github.com/dimagi/commcare-cloud/blob/master/changelog/README.md for instructions-->
+# 97. Set minimum git version to 2.49
+
+**Date:** 2026-05-05
+
+**Optional per env:** _required on all environments_
+
+
+## CommCare Version Dependency
+This change is not known to be dependent on any particular version of CommCare.
+
+
+## Change Context
+commcare-cloud now requires git 2.49 or later on all machines that install git
+via the `git` ansible role (control machines and any other host that runs git
+for commcare-cloud purposes).
+
+## Details
+Pinning a minimum git version lets us rely on features from recent git
+releases without having to first check what's installed on each machine.
+The `ppa:git-core/ppa` repository (already configured by this role) ships
+versions well past 2.49 for all supported Ubuntu releases, so the upgrade
+is just a matter of running the install_git tag.
+
+## Steps to update
+Update git on all machines in your environment:
+
+```bash
+cchq <env> deploy-stack --tags=install_git
+```
+
+Then verify:
+
+```bash
+cchq <env> run-shell-command all 'git --version'
+```
+
+Output should show `git version 2.49.x` or later on every host.

docs/source/changelog/index.md

@@ -7,6 +7,13 @@ need to be applied on your environment to keep it up to date.
 
 ### Changelog
 
+#### **2026-05-05** [Set minimum git version to 2.49](0097-min-git-version.md)
+commcare-cloud now requires git 2.49 or later on all machines that install git
+via the `git` ansible role (control machines and any other host that runs git
+for commcare-cloud purposes).
+
+
+---
 #### **2026-04-08** [Migrate Celery Broker to Redis](0096-migrate-celery-broker-to-redis.md)
 On June 1st, 2026, we will be dropping support for RabbitMQ as a broker for celery.
 

src/commcare_cloud/ansible/roles/git/tasks/main.yml

@@ -10,7 +10,7 @@
   become: yes
   apt:
     name:
-      - git
+      - git>=1:2.49.0
     state: latest
   tags:
     - install_git