README
¶
OpenShift Installer
Supported Platforms
- AWS
- AWS (UPI)
- Azure
- Bare Metal (UPI)
- Bare Metal (IPI)
- GCP
- GCP (UPI)
- Libvirt with KVM (development only)
- OpenStack
- OpenStack (UPI)
- Power
- oVirt
- oVirt (UPI)
- vSphere
- vSphere (UPI)
- z/VM
Quick Start
First, install all build dependencies.
Clone this repository. Then build the openshift-install binary with:
hack/build.sh
This will create bin/openshift-install. This binary can then be invoked to create an OpenShift cluster, like so:
bin/openshift-install create cluster
The installer will show a series of prompts for user-specific information and use reasonable defaults for everything else.
In non-interactive contexts, prompts can be bypassed by providing an install-config.yaml.
If you have trouble, refer to the troubleshooting guide.
Connect to the cluster
Details for connecting to your new cluster are printed by the openshift-install binary upon completion, and are also available in the .openshift_install.log file.
Example output:
INFO Waiting 10m0s for the openshift-console route to be created...
INFO Install complete!
INFO To access the cluster as the system:admin user when using 'oc', run
export KUBECONFIG=/path/to/installer/auth/kubeconfig
INFO Access the OpenShift web-console here: https://console-openshift-console.apps.${CLUSTER_NAME}.${BASE_DOMAIN}:6443
INFO Login to the console with user: kubeadmin, password: 5char-5char-5char-5char
Cleanup
Destroy the cluster and release associated resources with:
openshift-install destroy cluster
Note that you almost certainly also want to clean up the installer state files too, including auth/, terraform.tfstate, etc.
The best thing to do is always pass the --dir argument to create and destroy.
And if you want to reinstall from scratch, rm -rf the asset directory beforehand.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
We want to keep the stream metadata stored "directly" in git so it's easy to read and validate.
|
We want to keep the stream metadata stored "directly" in git so it's easy to read and validate. |
|
pkg
|
|
|
asset
Package asset defines the asset dependencies and implements the graph engine.
|
Package asset defines the asset dependencies and implements the graph engine. |
|
asset/cluster
Package cluster contains asset targets that generates the terraform file, prepare the infra, and bootstrap the cluster.
|
Package cluster contains asset targets that generates the terraform file, prepare the infra, and bootstrap the cluster. |
|
asset/cluster/aws
Package aws extracts AWS metadata from install configurations.
|
Package aws extracts AWS metadata from install configurations. |
|
asset/cluster/azure
Package azure extracts AZURE metadata from install configurations.
|
Package azure extracts AZURE metadata from install configurations. |
|
asset/cluster/baremetal
Package baremetal extracts bare metal metadata from install configurations.
|
Package baremetal extracts bare metal metadata from install configurations. |
|
asset/cluster/gcp
Package gcp extracts GCP metadata from install configurations.
|
Package gcp extracts GCP metadata from install configurations. |
|
asset/cluster/ibmcloud
Package ibmcloud extracts IBM Cloud metadata from install configurations.
|
Package ibmcloud extracts IBM Cloud metadata from install configurations. |
|
asset/cluster/openstack
Package openstack extracts OpenStack metadata from install configurations.
|
Package openstack extracts OpenStack metadata from install configurations. |
|
asset/cluster/ovirt
Package ovirt extracts ovirt metadata from install configurations.
|
Package ovirt extracts ovirt metadata from install configurations. |
|
asset/cluster/powervs
Package powervs extracts Power VS metadata from install configurations.
|
Package powervs extracts Power VS metadata from install configurations. |
|
asset/installconfig
Package installconfig generates the install config assets based on its dependencies.
|
Package installconfig generates the install config assets based on its dependencies. |
|
asset/installconfig/aws
Package aws collects AWS-specific configuration.
|
Package aws collects AWS-specific configuration. |
|
asset/installconfig/aws/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
asset/installconfig/azure/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
asset/installconfig/baremetal
Package baremetal collects bare metal specific configuration.
|
Package baremetal collects bare metal specific configuration. |
|
asset/installconfig/gcp/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
asset/installconfig/ibmcloud/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
asset/installconfig/nutanix
Package nutanix collects Nutanix-specific configuration.
|
Package nutanix collects Nutanix-specific configuration. |
|
asset/installconfig/openstack
Package openstack collects OpenStack-specific configuration.
|
Package openstack collects OpenStack-specific configuration. |
|
asset/installconfig/powervs/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
asset/installconfig/vsphere
Package vsphere collects vSphere-specific configuration.
|
Package vsphere collects vSphere-specific configuration. |
|
asset/installconfig/vsphere/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
asset/kubeconfig
Package kubeconfig defines and generates the kubeconfig assets.
|
Package kubeconfig defines and generates the kubeconfig assets. |
|
asset/machines
Package machines is responsible for creating Machine objects for machinepools.
|
Package machines is responsible for creating Machine objects for machinepools. |
|
asset/machines/aws
Package aws generates Machine objects for aws.
|
Package aws generates Machine objects for aws. |
|
asset/machines/azure
Package azure generates Machine objects for azure.
|
Package azure generates Machine objects for azure. |
|
asset/machines/baremetal
Package baremetal generates Machine objects for bare metal.
|
Package baremetal generates Machine objects for bare metal. |
|
asset/machines/gcp
Package gcp generates Machine objects for gcp.
|
Package gcp generates Machine objects for gcp. |
|
asset/machines/nutanix
Package generates capi Machine objects for nutanix.
|
Package generates capi Machine objects for nutanix. |
|
asset/machines/openstack
Package openstack generates Machine objects for openstack.
|
Package openstack generates Machine objects for openstack. |
|
asset/machines/ovirt
Package ovirt generates Machine objects for ovirt.
|
Package ovirt generates Machine objects for ovirt. |
|
asset/machines/powervs
Package powervs generates Machine objects for powerVS.
|
Package powervs generates Machine objects for powerVS. |
|
asset/machines/vsphere
Package vsphere generates Machine objects for vsphere.
|
Package vsphere generates Machine objects for vsphere. |
|
asset/manifests
Package manifests deals with creating manifests for all manifests to be installed for the cluster
|
Package manifests deals with creating manifests for all manifests to be installed for the cluster |
|
asset/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
asset/rhcos
Package rhcos contains assets for RHCOS.
|
Package rhcos contains assets for RHCOS. |
|
asset/templates
Package templates deals with creating template assets that will be used by other assets
|
Package templates deals with creating template assets that will be used by other assets |
|
asset/tls
Package tls defines and generates the tls assets based on its dependencies.
|
Package tls defines and generates the tls assets based on its dependencies. |
|
clusterapi/internal/process/flock
Package flock is copied from k8s.io/kubernetes/pkg/util/flock to avoid importing k8s.io/kubernetes as a dependency.
|
Package flock is copied from k8s.io/kubernetes/pkg/util/flock to avoid importing k8s.io/kubernetes as a dependency. |
|
destroy
Package destroy contains tools for destroying clusters based on their metadata.
|
Package destroy contains tools for destroying clusters based on their metadata. |
|
destroy/aws
Package aws provides a cluster-destroyer for AWS clusters.
|
Package aws provides a cluster-destroyer for AWS clusters. |
|
destroy/azure
Package azure provides a cluster-destroyer for Azure clusters.
|
Package azure provides a cluster-destroyer for Azure clusters. |
|
destroy/baremetal
Package baremetal provides a cluster-destroyer for bare metal clusters.
|
Package baremetal provides a cluster-destroyer for bare metal clusters. |
|
destroy/bootstrap
Package bootstrap uses Terraform to remove bootstrap resources.
|
Package bootstrap uses Terraform to remove bootstrap resources. |
|
destroy/gcp
Package gcp provides a cluster-destroyer for GCP clusters.
|
Package gcp provides a cluster-destroyer for GCP clusters. |
|
destroy/ibmcloud
Package ibmcloud provides a cluster-destroyer for IBM Cloud clusters.
|
Package ibmcloud provides a cluster-destroyer for IBM Cloud clusters. |
|
destroy/nutanix
Package nutanix provides a cluster-destroyer for nutanix clusters
|
Package nutanix provides a cluster-destroyer for nutanix clusters |
|
destroy/openstack
Package openstack provides a cluster-destroyer for openstack clusters.
|
Package openstack provides a cluster-destroyer for openstack clusters. |
|
destroy/ovirt
Package ovirt provides a cluster-destroyer for ovirt clusters.
|
Package ovirt provides a cluster-destroyer for ovirt clusters. |
|
destroy/vsphere
Package vsphere provides a cluster-destroyer for vsphere clusters
|
Package vsphere provides a cluster-destroyer for vsphere clusters |
|
destroy/vsphere/mock
Package mock is a generated GoMock package.
|
Package mock is a generated GoMock package. |
|
gather
Package gather contains platform specific methods for gathering console logs.
|
Package gather contains platform specific methods for gathering console logs. |
|
gather/service
Package service is used to analyze service json files from an installation that failing to bootstrap.
|
Package service is used to analyze service json files from an installation that failing to bootstrap. |
|
gather/ssh
Package ssh contains utilities that help gather logs, etc.
|
Package ssh contains utilities that help gather logs, etc. |
|
infrastructure/baremetal
This file is largely based on existing code from terraform-provider-libvirt 0.6.12.
|
This file is largely based on existing code from terraform-provider-libvirt 0.6.12. |
|
ipnet
Package ipnet wraps net.IPNet to get CIDR serialization.
|
Package ipnet wraps net.IPNet to get CIDR serialization. |
|
lineprinter
Package lineprinter wraps a Print implementation to provide an io.WriteCloser.
|
Package lineprinter wraps a Print implementation to provide an io.WriteCloser. |
|
quota
Package quota provides functions to fetch and check quotas for various cloud environments.
|
Package quota provides functions to fetch and check quotas for various cloud environments. |
|
rhcos
Package rhcos contains helpers for RHCOS related operations.
|
Package rhcos contains helpers for RHCOS related operations. |
|
terraform
Package terraform contains the utilities that's used for invoking terraform executable under the given directory with the given templates.
|
Package terraform contains the utilities that's used for invoking terraform executable under the given directory with the given templates. |
|
tfvars
Package tfvars generates Terraform variables for launching the cluster.
|
Package tfvars generates Terraform variables for launching the cluster. |
|
tfvars/aws
Package aws contains AWS-specific Terraform-variable logic.
|
Package aws contains AWS-specific Terraform-variable logic. |
|
tfvars/baremetal
Package baremetal contains bare metal specific Terraform-variable logic.
|
Package baremetal contains bare metal specific Terraform-variable logic. |
|
tfvars/libvirt
Package libvirt contains libvirt-specific Terraform-variable logic.
|
Package libvirt contains libvirt-specific Terraform-variable logic. |
|
tfvars/openstack
Package openstack contains OpenStack-specific Terraform-variable logic.
|
Package openstack contains OpenStack-specific Terraform-variable logic. |
|
tfvars/ovirt
Package ovirt contains ovirt-specific Terraform-variable logic.
|
Package ovirt contains ovirt-specific Terraform-variable logic. |
|
tfvars/powervs
Package powervs contains Power Virtual Servers-specific Terraform-variable logic.
|
Package powervs contains Power Virtual Servers-specific Terraform-variable logic. |
|
types
Package types defines structures for installer configuration and management.
|
Package types defines structures for installer configuration and management. |
|
types/aws
Package aws contains AWS-specific structures for installer configuration and management.
|
Package aws contains AWS-specific structures for installer configuration and management. |
|
types/azure
Package azure contains Azure-specific structures for installer configuration and management.
|
Package azure contains Azure-specific structures for installer configuration and management. |
|
types/baremetal
Package baremetal contains baremetal-specific structures for installer configuration and management.
|
Package baremetal contains baremetal-specific structures for installer configuration and management. |
|
types/external
Package none contains generic structures for installer configuration and management.
|
Package none contains generic structures for installer configuration and management. |
|
types/gcp
Package gcp contains GCP-specific structures for installer configuration and management.
|
Package gcp contains GCP-specific structures for installer configuration and management. |
|
types/ibmcloud
Package ibmcloud contains IBM Cloud-specific structures for installer configuration and management.
|
Package ibmcloud contains IBM Cloud-specific structures for installer configuration and management. |
|
types/none
Package none contains generic structures for installer configuration and management.
|
Package none contains generic structures for installer configuration and management. |
|
types/nutanix
Package nutanix contains Nutanix-specific structures for installer configuration and management.
|
Package nutanix contains Nutanix-specific structures for installer configuration and management. |
|
types/openstack
Package openstack contains OpenStack-specific structures for installer configuration and management.
|
Package openstack contains OpenStack-specific structures for installer configuration and management. |
|
types/ovirt
Package ovirt contains ovirt-specific structures for installer configuration and management.
|
Package ovirt contains ovirt-specific structures for installer configuration and management. |
|
types/powervs
Package powervs contains Power VS-specific structures for installer configuration and management.
|
Package powervs contains Power VS-specific structures for installer configuration and management. |
|
types/vsphere
Package vsphere contains vSphere-specific structures for installer configuration and management.
|
Package vsphere contains vSphere-specific structures for installer configuration and management. |
|
validate
Package validate contains validation utilities for installer types.
|
Package validate contains validation utilities for installer types. |
|
version
Package version includes the version information for installer.
|
Package version includes the version information for installer. |
|
terraform
|
|
|
providers/alicloud
Module
|
|
|
providers/aws
Module
|
|
|
providers/azureprivatedns
Module
|
|
|
providers/azurerm
Module
|
|
|
providers/azurestack
Module
|
|
|
providers/google
Module
|
|
|
providers/ibm
Module
|
|
|
providers/ignition
Module
|
|
|
providers/ironic
Module
|
|
|
providers/libvirt
Module
|
|
|
providers/local
Module
|
|
|
providers/nutanix
Module
|
|
|
providers/openstack
Module
|
|
|
providers/ovirt
Module
|
|
|
providers/random
Module
|
|
|
providers/time
Module
|
|
|
providers/vsphere
Module
|
|
|
providers/vsphereprivate
Module
|
Click to show internal directories.
Click to hide internal directories.