Create an Object Storage Bucket

To export design-time metadata into an Oracle Integration instance, you must create a storage bucket if one does not already exist.

Note:

Do not create a Classic Storage bucket. Classic Storage is not supported.
  1. Log in to the My Services Console with the user that the administrator added to the group for exporting design-time metadata. You must have the admin role to access this page.

  2. If the Compute section is not displayed, select Customize Dashboard button in the upper right corner of the My Services Dashboard.

    1. Click Show in the Compute section. This enables this service to appear on the My Services page.


      Compute section with Automatic, Show, and Hide buttons to the right
  3. Click Compute to access the Oracle Cloud Infrastructure page.

  4. In the upper right corner, click Open Service Console button.

  5. In the upper left corner of the Oracle Cloud Infrastructure page, click hamburger menu.

  6. Select Object Storage > Object Storage.

  7. Select the compartment in which to create the storage bucket. The compartment to use for exporting design-time metadata was created in Create a Cloud Storage Compartment, User, Group, and Policies. You can also click Learn more about Compartments to find the appropriate compartment for your environment.

  8. After determining the compartment to use, click Create Bucket.


    Description of create_bucket.png follows
    Description of the illustration create_bucket.png
  9. In the Bucket Name field, enter a name.

  10. In the Storage Tier section, select Standard.

  11. Click Create Bucket.

    The new bucket is displayed in the list.
    Buckets in Integration Compartment dialog with Create Bucket button at top and existing bucket named cloneRepo.

  12. If you want to view bucket details, click the name (for this example, cloneRepo).

    Note:

    Ensure that you click the Update Visibility button. This action ensures that the storage bucket you create is publicly visible. Otherwise, the export utility cannot see the storage.
    Visibility is set to Public
  13. In the upper left corner of the page, click hamburger menu.

  14. Select Identity > Users. This opens the Oracle Identity Service Console to generate a password.

  15. Select the appropriate user.

  16. From the Resources list on the left side of the page, select Auth Tokens.

  17. Click Generate Token button.

  18. Provide a token description and click Generate Token button.

    This token is used as part of your JSON payload when upgrading.

  19. Copy and save the generated token.

    a. The storage payload format is as follows with object storage bucket details:
    {"storageInfo":
           {
                 "storageUrl":"https://swiftobjectstorage.region.oraclecloud.com/v1/
    namespace/bucket",
                 "storageUser":"my.email@oracle.com",
                 "storagePassword":"generated_token"
                }
    }
    For example:
    {
          "storageInfo":
                {
                      "storageUrl":"https://swiftobjectstorage.us-ashburn-1.oraclecloud.
    com/v1/paasdevoic/cloneRepo",
                      "storageUser":"my.email@oracle.com",
                      "storagePassword":"generated_token"
                }
    }
  20. Construct the storage URL.
    Step Description Example
    1 Enter the Swift API as the base for the URL because you are dealing with object storage. https://swiftobjectstorage
    2 Enter a required data center. To find a data center, navigate to Menu > Administration > Tenancy Details > Home Region (for example: us-ashburn-1). https://swiftobjectstorage.us-ashburn-1
    3 Enter the domain name. This is typically oraclecloud.com. https://swiftobjectstorage.us-ashburn-1.oraclecloud.com
    4 Enter the version: v1. https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1
    5 Enter the automatically generated object storage namespace. Open the User menu and click Tenancy: your_tenancy_name. The namespace string is listed under Object Storage Settings. See Understanding Object Storage Namespaces. paasdevoic
    6 Enter the bucket name as the last part of the URL. https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/BUCKET_NAME
    Examples of the full storage URL to use later in the payload are as follows:
    https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/cloneRepo
    https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/migrationartifacts_bucket-20190717-1223