Creating an Oracle Container Cloud Service Instance


Options



Before You Begin

Purpose

This tutorial shows you how to use Oracle Container Cloud Service's Service Console to create a new service instance.

Time to Complete

15 minutes (depending on time taken to create and provision the new instance)

Background

This tutorial shows you how to:

  • access Oracle Container Cloud Service's Service Console
  • create a new service instance

Scenario

During this tutorial you will:

  1. Access Oracle Container Cloud Service's Service Console.
  2. Create a new service instance.
  3. Display the Container Console to verify the service instance is running.
  4. Tidy up.

What Do You Need?

Required Resource/Tool: Details:
Web browser A web browser is required for working with Oracle Cloud services. These are the minimum requirements for Oracle Container Cloud Service:
  • Microsoft Internet Explorer 11.
  • Google Chrome 29 and later
  • Mozilla Firefox 24 and later
  • Apple Safari 9 and later
Subscription to Oracle Container Cloud Service Before you can use Oracle Container Cloud Service:
  • You, or someone else in your organization, must have ordered and activated an Oracle Container Cloud Service subscription

For more information, see Using Oracle Container Cloud Service in the Oracle Help Center.


1. Access the Service Console

You use the Service Console for Oracle Container Cloud Service to create new service instances, as well as to administer and monitor service instances.

  1. Sign in to the My Services application at the URL and using the credentials you’ve received, either from your administrator or in an email from Oracle Cloud.
  2. In the My Services dashboard, navigate to the Oracle Container Cloud Service entry and select Open Service Console from the menu.

  3. On the Service Details page, click Open Service Console to display the Services tab of the Oracle Container Cloud Service Console.
  4. Services tab 
    Description of this image

2. Create a New Service Instance

  1. On the Services tab of the Oracle Container Cloud Service Console, click Create Service to display the Oracle Container Cloud Service Instance Creation Wizard.
  2. Service Details page 
    Description of this image
  3. Specify a name and description for the new service instance as follows:
    • Service Name: tutorial-instance
    • Service Description: Tutorial instance
  4. Click the Edit button beside the SSH Public Key field.
  5. Service Details page 
    Description of this image
  6. In the Public key input for VM access dialog, select the Create a New Key option and click Enter.
  7. Public key input for VM access dialog 
    Description of this image
  8. In the Download Keys dialog, click Download.
  9. Download Keys dialog 
    Description of this image
  10. Specify a temporary location in which to save the sshkeybundle.zip file.
  11. Tip: You won't be using the sshkeybundle.zip file during this tutorial but you'll be deleting it later for the sake of good housekeeping, so make a note of the temporary location you specify.

  12. Click Done in the Download Keys dialog.
  13. Download Keys dialog 
    Description of this image
  14. Back in the Service Instance Creation Wizard, enter credentials for the instance administrator as follows:
    • Admin Username: admin (the default)
    • Admin Password: specify a password of your choosing

    Tip: Make a note of the password as you'll need it in a moment.

  15. For the purposes of this tutorial, the default values for the Worker node settings are fine, so don't change them.
  16. Service Details page 
    Description of this image
  17. Click Next and check the details you've entered on the Confirmation page.
  18. Click Create to create the Oracle Container Cloud Service instance.
  19. Confirmation page 
    Description of this image
  20. The Services tab of the Oracle Container Cloud Service Console is displayed, showing the new tutorial-instance instance and the message Creating service ... in the Status field.
  21. Services tab 
    Description of this image

    Tip: Click Creating service ... to see the progress and the messages output during the instance creation process. From time-to-time, click the refresh icon Refresh icon beside the Create Service button to check whether the instance has been created.

  22. Within a few minutes, the new tutorial-instance instance is created with the details you specified, and the message Creating service ... in the Status field disappears.
  23. Click the name of the tutorial-instance to see more information about the instance on the Service Details page.
  24. Service Details page 
    Description of this image

    You can see that two Virtual Machines (VMs) have been created:

    • one VM is the manager node, running Oracle Container Cloud Service
    • one VM is a worker node on which Docker containers will be deployed
    Instance Overview page 
    Description of this image

3. Display the Container Console to Verify the Service Instance is Running

Now you've created the service instance, you can verify it's up-and-running by starting the Container Console on the manager node.
  1. Click the menu icon Menu icon beside the tutorial-instance name at the top of the screen and choose Container Console.
  2. Instance Overview page 
    Description of this image
  3. Choose Container Console to display the Container Console login window.
  4. Container Console login window 
    Description of this image
  5. Enter the following credentials and click Login:
    • Username: admin
    • Password: [the password you specified earlier]

    The Container Console's Dashboard page is displayed.

    Container Console Dashboard 
    Description of this image

    You can see the hosts (the worker nodes) that are available and the standard resource pools that have been created (default, Development,and Production). This is where you'll manage and monitor your Docker environment.

    Congratulations! You've successfully created a new Oracle Container Cloud Service instance and verified that it's up and running.

4. Tidying up

As good practice, let's delete the tutorial-instance you've created and the sshkeybundle.zip file you downloaded earlier.

  1. In the Container Console, click Logout.
  2. Go back to the Service Console and on the Service Details page, click Oracle Container Cloud Service to return to the Services Summary page
  3. Instance Overview page 
    Description of this image
  4. On the Services Summary page, click the menu icon Menu icon beside the tutorial-instance.
  5. Services Summary page 
    Description of this image
  6. Choose Delete and confirm that you want to delete the tutorial instance.
  7. The message Terminating service ... appears in the Status field.

    Services Summary page 
    Description of this image

    Tip: From time-to-time, click the refresh icon Refresh icon beside the Create Service button to check whether the instance has been deleted.

  8. For the sake of good housekeeping, delete the sshkeybundle.zip file from the temporary location in which you saved it earlier.

Want to Learn More?