Artifacts
What is an Artifact?
An artifact is simply a smaller component or informational property of a larger object, resource, or service that acts in a manner to produce or determine an intended output. It can also be defined as the logic that defines what elements of a deployment have to be installed and how. These informational pieces are created to be used for the deployment and operation of a system.
Airctl and Helpers
The following artifacts are used to aid in the implementation and configuration of the different airctl elements.
- airctl-<version>.tar.gz: This compressed file contains the airctl binary. This is the primary CLI tool used for management of the Platform9 Self Managed Cloud Platform (SMCP)
- airctl-scripts-<version>.tar.gz: This compact file contains all the associated scripts used by airctl
- install.sh: Script to install the downloaded artifacts to proper location on the node
- nodelet.tar.gz: This file contains the nodelet package needed for the management cluster creation. We have nodelet-deb.tar.gz for ubuntu 22.04 OS.
Offline Packages
The following artifacts are primarily employed for offline (or air-gapged) edge cloud installations.
hostagent-<version>.tar.gz: This file contains the yum or apt repo information for the platform9 agents running on the hosts. Platform9 automatically deploys this and sets up the repository.
- Note: Depending on the OS of the nodes being onboarded, users might have to specify different variant of this in the airctl-config.yaml
- Centos7.9: hostagent-<version>.tar.gz
- RHEL 8.5, RHEL 8.6: hostagent-8-<version>.tar.gz
- Rocky linux 9.2: hostagent-9-<version>.tar.gz
- Ubuntu 22.04: hostagent-ubuntu-<version>.tar.gz
- Note: Depending on the OS of the nodes being onboarded, users might have to specify different variant of this in the airctl-config.yaml
docker-<version>.tar.gz: Similar to the file above, it can be installed using Platform9 airctl command.
- Note: Depending on the OS of the nodes being onboarded, users might have to specify different variant of this in the airctl-config.yaml
- Centos7.9: docker-<version>.tar.gz
- RHEL 8.5, RHEL 8.6: docker-8-<version>.tar.gz
- Rocky linux 9.2: docker-9-<version>.tar.gz
- Ubuntu 22.04: docker-ubuntu-<version>.tar.gz
- Note: Depending on the OS of the nodes being onboarded, users might have to specify different variant of this in the airctl-config.yaml
docker-imgs-<version>.tar.gz: This file contains all the docker images that Platform9 initially requires. Airctl can add it to the cache of every host.
pf9-kube-<version>.tar.gz: This file contains the packages needed for a Kubernetes multi-version implementation
nodelet-imgs-<version>.tar.gz: It contains the images needed for the management base kubernetes cluster creation.
kubedu-imgs-<version>.tar.gz: It contains the images needed to bring up the SMCP management plane.
k8s-<version>-<addon>.tar.gz: This file contains the images needed for specific kube versions and addons which we upload to DU registry for the workload cluster nodes.
Installed File Locations
Once setup, all the installed files are located under the /opt/pf9/airctl directory.
[centos@test-pf9-du-host-airgap-c7-3246245-310 airctl]$ ls -latotal 1062408drwxr-xr-x. 7 centos root 4096 May 2 11:45 .drwxr-xr-x. 8 pf9 pf9group 121 May 2 11:58 ..-rwxr-xr-x. 1 centos centos 126097165 Apr 30 11:18 airctldrwxr-xr-x. 7 centos centos 4096 May 2 12:25 conf-rw-rw-r--. 1 centos centos 160695185 May 2 11:45 docker-8-v-5.10.0-3242354.tar.gz-rw-rw-r--. 1 centos centos 151283967 May 2 11:45 docker-9-v-5.10.0-3242354.tar.gz-rw-rw-r--. 1 centos centos 48595990 May 2 11:45 docker-ubuntu-v-5.10.0-3242354.tar.gz-rw-rw-r--. 1 centos centos 139954392 May 2 11:45 docker-v-5.10.0-3242354.tar.gz-rw-rw-r--. 1 centos centos 130617606 May 2 11:44 hostagent-8-v-5.10.0-3242354.tar.gz-rw-rw-r--. 1 centos centos 122842610 May 2 11:45 hostagent-9-v-5.10.0-3242354.tar.gz-rw-rw-r--. 1 centos centos 116555543 May 2 11:45 hostagent-ubuntu-v-5.10.0-3242354.tar.gz-rw-rw-r--. 1 centos centos 91233770 May 2 11:44 hostagent-v-5.10.0-3242354.tar.gzdrwxr-xr-x. 2 centos root 4096 May 2 11:44 imgsdrwxr-xr-x. 2 centos root 54 May 2 11:37 nodeletdrwxr-xr-x. 2 centos root 29 May 2 11:37 pf9-kubedrwxr-xr-x. 2 centos centos 281 Apr 30 11:16 scripts