IBM Cloud Docs
Sharing your deployable architecture to your enterprise

Sharing your deployable architecture to your enterprise

This tutorial walks you through how to share a deployable architecture that you created from an IBM Cloud® pre-built deployable architecture. By completing this tutorial, you learn about sending a share request, viewing the status of your share request, and sharing your deployable architecture.

When you send a share request to an enterprise, you are requesting to add the enterprise to an allowlistA list of items, such as usernames, email addresses, or IP addresses, that are granted access to a certain system or function. When an allowlist is used for access control, all entities are denied access, except for those that are included in the allowlist.. After the enterprise owner accepts the request, you can share individual products and deployable architectures to enterprise users. You can share any version that is in the ready or pre-release state. For more information on states, go to Versioning workflow in your private catalog.

Not ready to share your deployable architecture, or are you not a part of an enterprise? You can skip this tutorial and continue on to deploying an architecture by using a project. Users in your account who have access to the private catalog that contains a draft version of your deployable architecture can deploy it.

Imagine you are a product manager for the fictitious company Example Corp. Your enterprise needs a deployable architecture to provide secure and customizable compute resources for running your applications and services. Your infrastructure architect browsed the IBM Cloud catalog and discovered the Cloud automation for Code Engine option, a deployable architecture that provides the foundation that you need. However, your infrastructure architect decided to modify the architecture to fully meet your business needs. Your cloud automation engineering professional named your new deployable architecture Example Corp's infrastructure and onboarded it to the private catalog Example Corp catalog. Now, you are ready to share Example Corp's infrastructure to the rest of your enterprise account Example Corp enterprise.

This tutorial uses a fictitious scenario to help you learn and understand how to share a deployable architecture. As you complete the tutorial, adapt each step to match your organization's needs.

Before you begin

  1. You must be assigned the Publisher and Viewer access roles for the Catalog Management service to share products. For more information, see Assigning users access.

  2. Verify that your account is part of an enterprise. You can create an enterprise from an existing Subscription account or a qualifying Pay-as-you-Go account. For more information, go to Creating an enterprise.

  3. Create a customized deployable architecture called Example Corp's infrastructure and onboard it to a private catalog called Example Corp catalog. This deployable architecture is the one you will be sharing as you complete this tutorial.

  4. Verify that at least one version of Example Corp's infrastructure is in the ready, test, or pre-release state. For more information on states, go to Versioning workflow in your private catalog.

Send a share request

To send a request to share deployable architectures and products to the enterprise, complete the following steps:

  1. In the IBM Cloud console, click Manage > Catalogs > Private catalogs.
  2. Select Example Corp catalog, which is where your deployable architecture is located.
  3. Select Example Corp's infrastructure.
  4. Click Actions > Share.
  5. Review the list of affected versions. If you don't see the version that you want to share, make sure that the version is in the ready, test, or pre-release state.
  6. Select Share to this enterprise or account groups to see the enterprise and its account groups.
  7. Select Example Corp enterprise to share to the enterprise and all account groups.
  8. Click Share.

In the version list, the Visibility status is now Pending. Next, the enterprise needs to accept the share request. For more information, see Accepting share requests for private catalog products.

Check the share request status

You can check the share request status by completing the following steps:

  1. In the IBM Cloud console, select Manage > Catalogs > Share requests.
  2. Click Sent requests to show the table of all your requests.
    • If the enterprise accepted the request, the request state is Accepted.
    • If the enterprise denied the request, the request state is Rejected.

After the enterprise accepts the request, your deployable architecture is shared with the enterprise. If your request is rejected, you need to reach out to the enterprise owner.

Contact the enterprise

You need to complete this step only if your share request is rejected. Since you are part of the enterprise you are sharing to, you can reach out to the enterprise owner to discuss the share request and discover if changes need to be made.

  1. Log in to the enterprise account.
  2. Click Manage > Enterprise > Accounts.
  3. In the Accounts table, find the email of the owner of the enterprise account.
  4. Send an email to the owner with details about the share request.

After the request is accepted, the Visibility status is now Shared in the version list. Users in your enterprise can now deploy the architecture by using a project.