Creating Oracle Container Cloud Service Instances

You can use a simple wizard to define and create Oracle Container Cloud Service instances, specifying (amongst other things) the number of worker nodes that can run Docker containers.

When you create an Oracle Container Cloud Service instance, you specify the username and password for an instance administrator. Use these credentials to launch the Oracle Container Cloud Service Container Console from the Oracle Container Cloud Service Console. You can change the instance administrator’s username and/or password later:

Every Oracle Container Cloud Service instance you create will always have one manager node, and the number of worker nodes that you specify. Oracle Container Cloud Service software running on the manager node orchestrates the deployment of Docker containers to the worker nodes in the instance.

Manager nodes and worker nodes are Oracle Compute virtual machines (VMs), also known as compute nodes or compute VMs. When you create an Oracle Container Cloud Service instance, you’re billed for the total number of compute VMs you request for the instance (the number of worker nodes, plus one manager node).

To create a new Oracle Container Cloud Service service instance using the Oracle Container Cloud Service Console:

  1. Navigate to the Service Console Services tab.
    If you’re not sure how to do this, see Accessing the Service Console for Oracle Container Cloud Service.
  2. Click Create Service to display the Oracle Container Cloud Service Instance Creation Wizard.
  3. Enter properties for the new service instance on the Details page of the Instance Creation Wizard as follows:
    Option Use to specify:
    Service Name A name for the service instance that is unique within the identity domain.
    Service Description An optional description to identify the service instance.
    SSH Public Key An existing public key (or a file containing the public key). Alternatively, you can generate a new public key.
    Admin Username The instance administrator’s username to use when logging into the Container Console. The default username in this field is ‘admin’, but you can change it now before you create the instance. And you can change the instance administrator’s username later if you need to, using the Container Console (see Changing the Username or Password for an Oracle Container Cloud Service Instance Administrator).
    Admin Password and Confirm Admin Password The instance administrator’s password to use when logging into the Container Console.

    The password can be a minimum of 8 and a maximum of 32 characters with at least 1 uppercase letter, 1 lowercase letter, and 1 number.

    Worker node Compute Shape The shape, or resource profile, that determines the number of CPUs and amount of memory assigned to each worker node in the service instance.
    Number of worker nodes The number of worker nodes (between 1 and 999) to create with the service instance.
    Worker node data volume size (GB) The size of the data volume available to each worker node.
  4. Click Next and review the details you’ve entered on the Confirmation page of the Oracle Container Cloud Service Instance Creation Wizard.
  5. Click Create to create the Oracle Container Cloud Service instance. The message Creating service ... appears in the Status field.

    Tip:

    Click Creating service ... to see the progress and the messages output during the instance creation process.

    Within a few minutes, the Oracle Container Cloud Service instance is created with the details you specified.

  6. Click the name of the newly created instance to see the virtual machines that have been created on the Service Details page.
  7. Optional: You can now administer the new Oracle Container Cloud Service instance by clicking the Menu icon Menu icon (beside the service instance name at the top of the page) and selecting:
  8. Optional: If other users are going to be using Oracle Container Cloud Service to manage and monitor your Docker environment, notify them of the URL and credentials to use to access the Container Console.
    The URL is in the format https://<manager-node-ip-address>/#/dashboard, where <manager-node-ip-address> is the public IP address of the manager node. For example, http://192.0.2.254/#/dashboard. You can find out the Container Console’s URL in either of the following ways:
    • On the Service Details page, click the Menu icon Menu icon (beside the service instance name at the top of the page), select Container Console, and copy the URL that’s used to launch the Container Console.

    • On the Service Details page, locate the manager node (the VM with the Instance Type set to MANAGER), copy the value in the Public IP field, and use that to construct the URL. For example, if the value in the Public IP field is 192.0.2.254, the Container Console’s URL is http://192.0.2.254/#/dashboard.