GBROWSE...OUD_VOL(1p)

💖 gbrowse_grow_cloud-vol — the manual page, but make it make sense 💖

okay bestie, sit down, hydrate, because we're talking about gbrowse_grow_cloud-vol, a Perl script from the 1p manual section. That's the whole name, no notes. It grows the GBrowse volume by the requested amount, and honestly? iconic behaviour. 👑

---

✨ NAME ✨

gbrowse_grow_cloud-vol — Grow the GBrowse volume by the requested amount. that's it, that's the job, she's a one-trick pony and the trick is slay. 💅

---

✨ SYNOPSYS ✨

(the original spells it like that, i don't make the rules, i just vibe with them 🫶)

Say you wanna grow /opt/gbrowse by another 100 gigabytes. You literally just do this:

% gbrowse_grow_cloud_vol 100

no flags, no drama, just a number and a dream. ✨

---

✨ DESCRIPTION ✨

So here's the tea: this script grows /opt/gbrowse by the requested number of gigabytes. 🌸

The single argument must be a number between 1 and 1000. And listen, this is the important part — that number is how many GB you want to grow the volume by, not the new size of the volume. not me almost messing that up 😭 read it twice, bestie.

How does she do it? Under the hood it:

1. creates a new EBS volume, and
2. adds it to the logical volume manager (LVM2) for this machine.

Then the filesystem is extended to the desired size. boom. glow up complete. 🦋

---

✨ COMMAND-LINE OPTIONS ✨

first things first: options can be abbreviated. fr fr. for example, you can use -a for --access_key. so casual, so convenient.

• --access_key — your EC2 access key. 🔑
• --secret_key — your EC2 secret key. 🤫 keep this one safe, okay? it's giving classified.

---

✨ ENVIRONMENT VARIABLES ✨

if you didn't pass the matching options above, the script will go looking in these instead. very "i'll find it myself" energy. 🙈

• EC2_ACCESS_KEY — your access key.
• EC2_SECRET_KEY — your secret key.

---

✨ SEE ALSO ✨

go read these too, they're part of the lore:

• VM::EC2
• VM::EC2::Staging::Manager

---

✨ AUTHOR ✨

Lincoln Stein, lincoln.stein@gmail.com 💜

Copyright (c) 2012 Ontario Institute for Cancer Research

This package and its accompanying libraries is free software; you can redistribute it and/or modify it under the terms of the GPL (either version 1, or at your option, any later version) or the Artistic License 2.0. Refer to LICENSE for the full license text. In addition, please see DISCLAIMER.txt for disclaimers of warranty.

🎀 no cap: if you're curious about the legal fine print, go actually read LICENSE and DISCLAIMER.txt. the girlies love informed consent to software licensing. 💖

---

okay that's the whole page, you ate that. go grow a volume, bestie. 💅✨

perl v5.40.0 · 2024-10-20 · GBROWSE...OUD_VOL(1p) — mwah, that's the version, the date and the page name, all wrapped up with a bow. 🎀🫶