garage_1_x: rename to garage_1

This commit is contained in:
Adam C. Stephens 2025-06-23 17:44:40 -04:00
parent 45c0608ace
commit 2b90c413df
No known key found for this signature in database
4 changed files with 6 additions and 10 deletions

View File

@ -7,9 +7,6 @@ The server setup can be automated using
client configured to your local Garage instance is available in
the global environment as `garage-manage`.
The current default by NixOS is `garage_0_8` which is also the latest
major version available.
## General considerations on upgrades {#module-services-garage-upgrade-scenarios}
Garage provides a cookbook documentation on how to upgrade:
@ -45,7 +42,7 @@ Here are some baseline instructions to handle advanced upgrades in Garage, when
- Run `systemctl stop garage` to stop the actual Garage version.
- Backup the metadata folder of ALL your nodes, e.g. for a metadata directory (the default one) in `/var/lib/garage/meta`,
you can run `pushd /var/lib/garage; tar -acf meta-v0.7.tar.zst meta/; popd`.
- Run the offline migration: `nix-shell -p garage_0_8 --run "garage offline-repair --yes"`, this can take some time depending on how many objects are stored in your cluster.
- Run the offline migration: `nix-shell -p garage_1 --run "garage offline-repair --yes"`, this can take some time depending on how many objects are stored in your cluster.
- Bump Garage version in your NixOS configuration, either by changing [stateVersion](#opt-system.stateVersion) or bumping [services.garage.package](#opt-services.garage.package), this should restart Garage automatically.
- Perform `garage-manage repair --all-nodes --yes tables` and `garage-manage repair --all-nodes --yes blocks`.
- Wait for a full table sync to run.
@ -77,8 +74,8 @@ packages, but mark them as insecure in an expression like this (in
```nix
/* ... */
{
garage_0_7_3 = generic {
version = "0.7.3";
garage_1_2_0 = generic {
version = "1.2.0";
sha256 = "0000000000000000000000000000000000000000000000000000";
eol = true;
};

View File

@ -133,10 +133,9 @@ rec {
garage_0_9 = garage_0_9_4;
garage_1_x = garage_1_2_0;
garage_1 = garage_1_x;
garage_1 = garage_1_2_0;
garage_2 = garage_2_0_0;
garage = garage_1_x;
garage = garage_1;
}

View File

@ -731,6 +731,7 @@ mapAliases {
gamin = throw "'gamin' has been removed as it is unmaintained upstream"; # Added 2024-04-19
garage_0_8 = throw "'garage_0_8' has been removed as it is unmaintained upstream"; # Added 2025-06-23
garage_0_8_7 = throw "'garage_0_8_7' has been removed as it is unmaintained upstream"; # Added 2025-06-23
garage_1_x = lib.warnOnInstantiate "'garage_1_x' has been renamed to 'garage_1'" garage_1; # Added 2025-06-23
gbl = throw "'gbl' has been removed because the upstream repository no longer exists"; # Added 2025-01-26
gcc48 = throw "gcc48 has been removed from Nixpkgs, as it is unmaintained and obsolete"; # Added 2024-09-10
gcc49 = throw "gcc49 has been removed from Nixpkgs, as it is unmaintained and obsolete"; # Added 2024-09-11

View File

@ -3029,7 +3029,6 @@ with pkgs;
garage_0_9_4
garage_1_2_0
garage_1_x
garage_1
garage_2_0_0