replicatedhq/replicated-docs

Docs feedback on Installing in an Air Gapped Environment

Closed this issue · 5 comments

dexhorthy commented

URL: https://docs.replicated.com/vendor/tutorial-installing-air-gap
Feedback details:

This stanza will lead folks to build an invalid URL if the channel name has an uppercase letter

export REPLICATED_APP=<app_slug>
export REPLICATED_CHANNEL=<channel_name>
curl -LS https://k8s.kurl.sh/bundle/$REPLICATED_APP-$REPLICATED_CHANNEL.tar.gz -o $REPLICATED_APP-$REPLICATED_CHANNEL.tar.gz

If they have the CLI installed should get the URL with replicated channel inspect $CHANNEL e.g. replicated channel inspect Unstable

paigecalvert commented

Thanks @dexhorthy !

To make sure I understand, the issue here is that there must be no uppercase letters in the https://k8s.kurl.sh/bundle/... URL.

So, rather than attempting to manually build the URL by assigning the environment variables as shown in this example, the preferred method is to use the replicated CLI to run replicated channel inspect $CHANNEL, then copy the URL that is provided in the "AIRGAP:" section of the output from that command (as shown in the example below):

replicated channel inspect cli-created
ID:             1xyB2Mgbg9N7rExShfbdBYIuzeW
NAME:           cli-created
DESCRIPTION:
RELEASE:        1
VERSION:        0.0.1
EXISTING:

    curl -fsSL https://kots.io/install | bash
    kubectl kots install cli-app/cli-created

EMBEDDED:

    curl -fsSL https://k8s.kurl.sh/cli-app-cli-created | sudo bash

AIRGAP:

    curl -fSL -o cli-app-cli-created.tar.gz https://k8s.kurl.sh/bundle/cli-app-cli-created.tar.gz
    # ... scp or sneakernet cli-app-cli-created.tar.gz to airgapped machine, then
    tar xvf cli-app-cli-created.tar.gz
    sudo bash ./install.sh airgap

I can get a story in our backlog for this.

jonquil2002 commented

The PR to fix this issue is here and in review now: #598

I'm closing this PR in favor of the other PR.

paigecalvert commented

@jonquil2002 going to re-open this Issue so that we can close it once the PR to address the feedback is merged (it'll of course probably be closed today anyway, but just to keep to a pattern of waiting to close Issues until the update to address the feedback is live on the docs site)

paigecalvert commented

PR merged! Closing this