Air-gapped install bootstrap script reference
To download the air-gapped installation bootstrap script on an internet-connected host with the same architecture and OS version as the Kubernetes cluster nodes intended for Portworx installation, use the following command:
./px-ag-install.sh [image-commands] [options] '[arguments...]'
The script name px-ag-install.sh
reflects the default name specified in the installation instructions, but can be whatever you named the script file when you downloaded it.
Image commands
Command | Description | Required? |
---|---|---|
pull | Pulls the Portworx container images locally | |
push <registry[/repo]> | Pushes the Portworx images into remote container registry server | |
load node1 [node2 [...]] | Loads the images tarball to remote nodes (note: ssh-access required) |
Options
Option | Description | Required? |
---|---|---|
--help | Displays help output | |
-I , --include <image> | Specify additional images to include | |
-E , --exclude <glob> | Specify images to EXCLUDE (e.g. -E 'csi') | |
-n , --dry-run | Show commands instead of running | |
-V , --version | Print version of the script | |
-v | Verbose output |
Load-specific options
Option | Description | Required? |
---|---|---|
-e , --rsh <command> | specify the remote shell to use (default ssh) | |
-L , --load-cmd <command> | specify the remote container-load command to use (default auto) | |
-t <prefix> | specify temporary tarball filename (default px-agtmp.tar) | |
--pks | assume PKS environment; transfer images using 'bosh' command |
Examples
-
Pull images from default container registries, push them to custom registry server (default repositories)
px-ag-install.sh pull push your-registry.company.com:5000
-
Pull images from default container registries, push them to custom registry server and portworx repository
px-ag-install.sh pull
px-ag-install.sh push your-registry.company.com:5000/portworx -
Push images to password-protected remote registry, then import docker/podman configuration as kuberentes secret
docker login your-registry.company.com:5000
px-ag-install.sh pull
px-ag-install.sh push your-registry.company.com:5000/portworx
px-ag-install.sh import-secrets -
Pull images, then load to given nodes using ssh
px-ag-install.sh pull
px-ag-install.sh load node1 node2 node33 node444 -
Pull images, then load to given nodes using ssh and root-account
px-ag-install.sh -e "ssh -l root" pull load node1 node2 node33 node444
-
Load images to given nodes using ssh and password '5ecr3t'
px-ag-install.sh -e "sshpass -p 5ecr3t ssh" load node1 node2 node33 node444
-
Pull ONLY busybox image, load it to given nodes
px-ag-install.sh -E '*' -I docker.io/busybox:latest pull load node1 node2 node33 node444