1 Introduction
This document contains information about performing a quick installation of Oracle Cloud Native Environment and a Kubernetes cluster. The information in this document provides a fast installation method using default settings for the Oracle Cloud Native Environment platform and Kubernetes cluster.
If you're not familiar with Oracle Cloud Native Environment, first read about the architecture, components, and terminology definitions in Concepts.
The installation examples in this document use the Oracle Cloud Native Environment Platform CLI (olcnectl
) to set
up the hosts and their OSs, and the Oracle Cloud Native Environment platform
and Kubernetes cluster. The installation options in this document offer a quick installation
option, with commands that set up the hosts and perform the installation automatically,
instead of using the longer procedure detailed in Getting Started.
The installation methods in this document require a minimum of options to be provided about hosts and uses that information to set up each host. During the host set up, the appropriate network ports are opened, the software packages are installed from the Oracle Linux yum server, CA Certificates are created, the OS services are configured, and finally, Kubernetes is deployed. This streamlines an installation of Oracle Cloud Native Environment to get you up and running.
You can also perform more complex deployments, setting security options, and installing optional modules using an Oracle Cloud Native Environment configuration file. Examples of using a configuration file are also included in this document.
Hosts
To start the installation, you need to set up a host with the Platform CLI
(olcnectl
). In this document, this installation host is
referred to as the operator node.
You also need to set up the hosts you want to include in the Kubernetes cluster (the Kubernetes control plane and worker nodes).
SSH key-based authentication must be set up between the installation host (operator node) and the hosts to be included in the Kubernetes cluster.
You might also need to set up a load balancer to use an external load balancer for High Availability of the Kubernetes control plane.
Platform CLI
The Platform CLI command, olcnectl provision
, is the command to use to
perform a quick installation, and is run from the operator node. This command sets up the
Kubernetes nodes, configures the node OSs, creates CA Certificates for the Kubernetes nodes,
installs the software packages from the Oracle Linux yum server, and creates a Kubernetes
cluster.
The installation examples in this document show you how to use the olcnectl
provision
command to perform an installation. The steps performed by
this command are:
-
Generate CA Certificates.
-
Copy the CA Certificates to each node.
-
Set up the OS on each node, including opening network ports.
-
Install the Oracle Cloud Native Environment software packages on each node.
-
Start the Oracle Cloud Native Environment platform services (Platform API Server and Platform Agent).
-
Create an Oracle Cloud Native Environment environment.
-
Create, validate, and install a Kubernetes module, which creates the Kubernetes cluster.
-
Set up the Platform CLI certificates to
~/.olcne
on the operator node to access the environment using theolcnectl
command. -
Install optional modules if using a configuration file.
If you use all the defaults when using the olcnectl provision
command, you install the most straight-forward installation option, using private CA
Certificates. We recommend for a production environment that you use CA Certificates.
For information on the syntax options for the olcnectl provision
command,
see Platform Command-Line Interface.
Complex Deployments
You can perform more complex installations by writing an Oracle Cloud Native Environment configuration file and passing the file
to the olcnectl provision
command using the
--config-file
option. A configuration file lets you specify
security options such as the SELinux setting on the nodes, the location of existing CA
Certificates and whether to deploy the Kubernetes externalIPs
service.
If you use a configuration file, you can also use the olcnectl
provision
command to install optional Oracle Cloud Native Environment modules, for example, the Istio module,
or the Oracle Cloud Infrastructure Cloud Controller Manager module.
If you want an installation that uses Vault to generate and authenticate the certificates for the Kubernetes nodes, use the full installation steps outlined in Getting Started.
For information on writing a configuration file, see Platform Command-Line Interface.
Install Examples
Several different installation types are provided to help you get up and running. Choose the option that best matches a deployment type you want, and use the installation example as a guide to get you started with an installation.
Table 1-1 Installation Examples
Install Type | Bare Metal or Virtual Machine | Oracle Cloud Infrastructure |
---|---|---|
Platform and Kubernetes |
||
Platform and Kubernetes HA |
||
Platform and Kubernetes with Optional Modules |
Quick HA Install using Configuration File on Oracle Cloud Infrastructure |