Offline Porter Installation

[jmcudd]

What does this change

The new bundle-linux.sh script automates the creation of a tarball containing all the necessary artifacts for installing the Porter CLI, including the MongoDB Docker image and the Porter installation files. It pulls a specific version of the MongoDB image and packages all the downloaded assets into a compressed tarball, providing clear instructions for extracting the bundle and executing the installation script. This makes it easy for users to set up Porter in air-gapped environments.

The install-linux.sh script has been updated to local or remote binaries, to facilitate an offline installation. This is accomplished by setting the PORTER_BINARY_URL to a file://<absolute-path-to-linux-binary> instead of the Porter CDN.

What issue does it fix

Closes #3198

Notes for the reviewer

This PR directly addresses feedback about complexity of the installation script in PR #3205

The bundle-linux.sh script pulls the latest version of the install-linux.sh from the CDN, so when testing you will need to replace the downloaded install-linux.sh file with the one from this branch. Use the following command.

cd scripts/bundle/
PORTER_SCRIPT_URL="file://$(realpath ../install/install-linux.sh)" bash bundle-linux.sh

Checklist

• Did you write tests?
• Did you write documentation?
• Did you change porter.yaml or a storage document record? Update the corresponding schema file.
• If this is your first pull request, please add your name to the bottom of our Contributors list. Thank you for making Porter better! 🙇‍♀️

[jmcudd]

@kichristensen I took your feedback, in PR #3205, about the added complexity in the install script and came up with an alternative that keeps things fairly simple.

One thing to note about this is it doesn't solve installation of mixins, I'm not sure how that would be solved.

[kichristensen]

@jmcudd Thanks for the PR, I will do some testing locally tomorrow and get back to you. But overall I like it

[kichristensen]

@kichristensen I took your feedback, in PR #3205, about the added complexity in the install script and came up with an alternative that keeps things fairly simple.

One thing to note about this is it doesn't solve installation of mixins, I'm not sure how that would be solved.

Could you update the documentation with a note, saying the mixins aren't handled by the script? Just to make it clear for users that mixins aren't currently handled

[kichristensen]

I also think it would make a lot if sense to add the script to the release just like we do with install-linux.sh (https://github.com/getporter/porter/blob/main/magefile.go#L491), and adding the Netlify redirect (like this one https://github.com/getporter/porter/blob/main/docs/static/_redirects#L64). That would allows to have the script versioned like the rest of the installation scripts.

[jmcudd]

Here is what I've addressed in my latest changes:

• Added note in docs about mixins not being included in the bundle
• Updated release to include the bundle-linux.sh script and update the PORTER_VERSION with sed
• Updated netlify to do the redirects

[schristoff]

This looks great, aside from Kim's documentation request. Thank you :)

[jmcudd]

I'll try to find some time this week to make the requested additions to the documentation.