github.com/openshift/installer@v1.4.17/docs/dev/openstack/customization.md (about)

     1  # RHCOS image customization
     2  
     3  By default the installer creates an image in Glance called `<clusterID>-rhcos`, and uploads the binary data from a predetermined in the installer location. The Glance image exists throughout the life of the cluster and is removed along with it.
     4  
     5  To change this behavior and upload binary data from a custom location the user may set `OPENSHIFT_INSTALL_OS_IMAGE_OVERRIDE` environment variable that points to that location, and then start the installation. In all other respects the process will be consistent with the default.
     6  
     7  Example:
     8  
     9  ```sh
    10  export OPENSHIFT_INSTALL_OS_IMAGE_OVERRIDE="https://example.com/my-rhcos.qcow2"
    11  ./openshift-install create cluster --dir ostest
    12  ```
    13  
    14  **NOTE:** For this to work, the environment variable value must be a valid http(s) URL.
    15  
    16  If the user wants to upload the image from the local file system, they can set the environment variable value as `file:///path/to/file`. In this case the installer will take this file and automatically create an image in Glance.
    17  
    18  Example:
    19  
    20  ```sh
    21  export OPENSHIFT_INSTALL_OS_IMAGE_OVERRIDE="file:///home/user/rhcos.qcow2"
    22  ./openshift-install create cluster --dir ostest
    23  ```
    24  
    25  If the user wants to reuse an existing Glance image without any uploading of binary data, then it is possible to set `OPENSHIFT_INSTALL_OS_IMAGE_OVERRIDE` environment variable that specifies the Glance image name. In this case no new Glance images will be created, and the image will stay when the cluster is destroyed.
    26  
    27  Example:
    28  
    29  ```sh
    30  export OPENSHIFT_INSTALL_OS_IMAGE_OVERRIDE="my-rhcos"
    31  ./openshift-install create cluster --dir ostest
    32  ```
    33  
    34  **NOTE:** The only difference in behavior with the previous examples is that the value here is not an "http(s)" or "file" URL.