Improve Offline Provider Installation Documentation

[arielsepton]

This PR enhances the Crossplane documentation for offline provider installations by:

•	Highlighting critical instructions with bold formatting.
•	Adding a troubleshooting tip for a more comprehensive guide.
•	Introducing an example script for configuring Crossplane with a PersistentVolumeClaim (PVC).

These changes aim to provide a detailed guide for setting up Crossplane providers offline.

[netlify]

✅ Deploy Preview for crossplane ready!

Name	Link
🔨 Latest commit	a646791
🔍 Latest deploy log	https://app.netlify.com/sites/crossplane/deploys/6573634ae5c8bd000832a63b
😎 Deploy Preview	https://deploy-preview-628--crossplane.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 90 (🟢 up 2 from production) Accessibility: 88 (🔴 down 3 from production) Best Practices: 83 (no change from production) SEO: 93 (no change from production) PWA: 70 (no change from production) View the detailed breakdown and full score reports

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[plumbis]

It looks like you may have accidentally pulled in a lot of other commits for this PR. Can you rebase or open a new PR that only includes your intended changes?

[arielsepton]

Thanks for catching that @plumbis! I've fixed the issue

[plumbis]

up xpkg xp-extract is a hidden command (the equiv is an alpha command) is it possible to use the crossplane CLI to do this?

Does the package have to be extracted?

[plumbis]

bump

[arielsepton]

Yes, the package does need to be extracted.
For Crossplane offline installation, with –set packageCache.pvc=<pvc name> option, The extracted packages must be placed in the directory where the PVC is mounted for Crossplane’s inner registry to recognize them.

Regarding the Crossplane CLI command you mentioned, Could you please provide me with the relevant documentation or details about the command? I’ll review it to see if we can replace the up xpkg xp-extract command with a Crossplane CLI equivalent.

[plumbis]

Documentation for the Crossplane CLI is here.

I'm not sure if extract is an option (even as a hidden command) but can you check to see if the options match what you're doing here? I'd prefer to have the Crossplane CLI in this doc but if Crossplane doesn't provide it and we have to reference the up CLI that's okay.

[plumbis]

There was an offline discussion that led to #733 , that the official recommendation for offline install is to run a local container registry. This avoids issues related to implementation details for the local Crossplane package cache.

I appreciate the work you put in to submit this PR but I'm going to close this now since it doesn't line up with the current Crossplane recommendations.