cs_hybrid.md

copyright	lastupdated	keywords	subcollection
years 2014, 2021	2021-04-06	kubernetes, iks, vpn, icp	containers

{:DomainName: data-hd-keyref="APPDomain"} {:DomainName: data-hd-keyref="DomainName"} {:android: data-hd-operatingsystem="android"} {:api: .ph data-hd-interface='api'} {:apikey: data-credential-placeholder='apikey'} {:app_key: data-hd-keyref="app_key"} {:app_name: data-hd-keyref="app_name"} {:app_secret: data-hd-keyref="app_secret"} {:app_url: data-hd-keyref="app_url"} {:authenticated-content: .authenticated-content} {:beta: .beta} {:c#: data-hd-programlang="c#"} {:cli: .ph data-hd-interface='cli'} {:codeblock: .codeblock} {:curl: .ph data-hd-programlang='curl'} {:deprecated: .deprecated} {:dotnet-standard: .ph data-hd-programlang='dotnet-standard'} {:download: .download} {:external: target="_blank" .external} {:faq: data-hd-content-type='faq'} {:fuzzybunny: .ph data-hd-programlang='fuzzybunny'} {:generic: data-hd-operatingsystem="generic"} {:generic: data-hd-programlang="generic"} {:gif: data-image-type='gif'} {:go: .ph data-hd-programlang='go'} {:help: data-hd-content-type='help'} {:hide-dashboard: .hide-dashboard} {:hide-in-docs: .hide-in-docs} {:important: .important} {:ios: data-hd-operatingsystem="ios"} {:java: .ph data-hd-programlang='java'} {:java: data-hd-programlang="java"} {:javascript: .ph data-hd-programlang='javascript'} {:javascript: data-hd-programlang="javascript"} {:new_window: target="_blank"} {:note .note} {:note: .note} {:objectc data-hd-programlang="objectc"} {:org_name: data-hd-keyref="org_name"} {:php: data-hd-programlang="php"} {:pre: .pre} {:preview: .preview} {:python: .ph data-hd-programlang='python'} {:python: data-hd-programlang="python"} {:route: data-hd-keyref="route"} {:row-headers: .row-headers} {:ruby: .ph data-hd-programlang='ruby'} {:ruby: data-hd-programlang="ruby"} {:runtime: architecture="runtime"} {:runtimeIcon: .runtimeIcon} {:runtimeIconList: .runtimeIconList} {:runtimeLink: .runtimeLink} {:runtimeTitle: .runtimeTitle} {:screen: .screen} {:script: data-hd-video='script'} {:service: architecture="service"} {:service_instance_name: data-hd-keyref="service_instance_name"} {:service_name: data-hd-keyref="service_name"} {:shortdesc: .shortdesc} {:space_name: data-hd-keyref="space_name"} {:step: data-tutorial-type='step'} {:subsection: outputclass="subsection"} {:support: data-reuse='support'} {:swift: .ph data-hd-programlang='swift'} {:swift: data-hd-programlang="swift"} {:table: .aria-labeledby="caption"} {:term: .term} {:tip: .tip} {:tooling-url: data-tooling-url-placeholder='tooling-url'} {:troubleshoot: data-hd-content-type='troubleshoot'} {:tsCauses: .tsCauses} {:tsResolve: .tsResolve} {:tsSymptoms: .tsSymptoms} {:tutorial: data-hd-content-type='tutorial'} {:ui: .ph data-hd-interface='ui'} {:unity: .ph data-hd-programlang='unity'} {:url: data-credential-placeholder='url'} {:user_ID: data-hd-keyref="user_ID"} {:vbnet: .ph data-hd-programlang='vb.net'} {:video: .video}

Hybrid cloud

{: #hybrid_iks_icp}

If you have an {{site.data.keyword.cloud}} Private account, you can use it with select {{site.data.keyword.cloud_notm}} services, including {{site.data.keyword.containerlong}}. {: shortdesc}

You understand the {{site.data.keyword.cloud_notm}} offerings and developed your Kubernetes strategy for what workloads to run on the cloud. Now, you can connect your public and private cloud by using the strongSwan VPN service or {{site.data.keyword.BluDirectLink}}.

• The strongSwan VPN service securely connects your Kubernetes cluster with an on-premises network through a secure end-to-end communication channel over the internet that is based on the industry-standard Internet Protocol Security (IPSec) protocol suite.
• With {{site.data.keyword.dl_full_notm}}, you can create a direct, private connection between your remote network environments and {{site.data.keyword.containerlong_notm}} without routing over the public internet.

After you connect your public and private cloud, you can reuse your private packages for public containers.

Connecting your public and private cloud with the strongSwan VPN

{: #hybrid_vpn}

Establish VPN connectivity between your public Kubernetes cluster and your {{site.data.keyword.Bluemix}} Private instance to allow two-way communication. {: shortdesc}

These steps are supported for classic clusters only. For VPC clusters, see Using VPN with your VPC. {: note}

1. Create a standard cluster with {{site.data.keyword.containerlong}} in {{site.data.keyword.cloud_notm}} Public or use an existing one. To create a cluster, choose between the following options:

   • Create a standard cluster from the console or CLI.
   • Use the Cloud Automation Manager (CAM) to create a cluster by using a pre-defined template{: external}. When you deploy a cluster with CAM, Helm is automatically installed for you.

2. In your {{site.data.keyword.containerlong_notm}} cluster, follow the instructions to set up the strongSwan IPSec VPN service.

   • For Step 2, note that:

     • The local.id that you set in your {{site.data.keyword.containerlong_notm}} cluster must match what you later set as the remote.id in your {{site.data.keyword.Bluemix}} Private cluster.
     • The remote.id that you set in your {{site.data.keyword.containerlong_notm}} cluster must match what you later set as the local.id in your {{site.data.keyword.Bluemix}} Private cluster.
     • The preshared.secret that you set in your {{site.data.keyword.containerlong_notm}} cluster must match what you later set as the preshared.secret in your {{site.data.keyword.Bluemix}} Private cluster.

   • For Step 3, configure strongSwan for an inbound VPN connection.

     ipsec.auto: add
     loadBalancerIP: <portable_public_IP>
     

     {: codeblock}

3. Note the portable public IP address that you set as the loadbalancerIP.

   kubectl get svc vpn-strongswan
   

   {: pre}

4. Create a cluster in {{site.data.keyword.cloud_notm}} Private{: external}.

5. In your {{site.data.keyword.cloud_notm}} Private cluster, deploy the strongSwan IPSec VPN service.

   1. Complete the strongSwan IPSec VPN workarounds{: external}.

   2. Set up the strongSwan VPN Helm chart{: external} in your private cluster.

      • In the configuration parameters, set the Remote gateway field to the value of the portable public IP address that you set as the loadbalancerIP of your {{site.data.keyword.containerlong_notm}} cluster.

        Operation at startup: start
        ...
        Remote gateway: <portable_public_IP>
        ...
        

        {: codeblock}

      • Remember that the private local.id must match the public remote.id, the private remote.id must match the public local.id, and the preshared.secret values for private and public must match.

      Now, you can initiate a connection from the {{site.data.keyword.cloud_notm}} Private cluster to the {{site.data.keyword.containerlong_notm}} cluster.

6. Test the VPN connection between your clusters.

7. Repeat these steps for each cluster that you want to connect.

What's next?

• Run your licensed software images in public clusters.
• To manage multiple cloud Kubernetes clusters such as across {{site.data.keyword.cloud_notm}} Public and {{site.data.keyword.cloud_notm}} Private, check out the IBM Multicloud Manager{: external}.

Connecting your public and private cloud with {{site.data.keyword.dl_full_notm}}

{: #hybrid_dl}

With {{site.data.keyword.BluDirectLink}}, you can create a direct, private connection between your remote network environments and {{site.data.keyword.containerlong_notm}} without routing over the public internet. {: shortdesc}

To choose an {{site.data.keyword.dl_full_notm}} offering and set up an {{site.data.keyword.dl_full_notm}} connection, see Get Started with {{site.data.keyword.dl_full_notm}} in the {{site.data.keyword.dl_full_notm}} documentation.

What's next?

• Run your licensed software images in public clusters.
• To manage multiple cloud Kubernetes clusters such as across {{site.data.keyword.cloud_notm}} Public and {{site.data.keyword.cloud_notm}} Private, check out the IBM Multicloud Manager{: external}.

Running {{site.data.keyword.cloud_notm}} Private images in public Kubernetes containers

{: #hybrid_ppa_importer}

You can run select licensed IBM products that were packaged for {{site.data.keyword.cloud_notm}} Private in a cluster in {{site.data.keyword.cloud_notm}} Public by using the PPA importer tool.
{: shortdesc}

The PPA importer tool is available only for older versions of entitled software. If you want to run entitled software from your MyIBM.com{: external} container software library, see Setting up a cluster to pull entitled software. {: note}

Licensed software is available in IBM Passport Advantage{: external}. To use this software in a cluster in {{site.data.keyword.cloud_notm}} Public, you must download the software, extract the image, and upload the image to your namespace in {{site.data.keyword.registryshort}} by using the PPA importer tool, the ibmcloud cr ppa-archive-load command. Independent of the environment where you plan to use the software, you must obtain the required license for the product first.

The following table is an overview of available {{site.data.keyword.cloud_notm}} Private products that you can use in your cluster in {{site.data.keyword.cloud_notm}} Public.

Product Name	Version	Part Number
IBM Db2 Direct Advanced Edition Server	11.1	CNU3TML
IBM Db2 Advanced Enterprise Server Edition Server	11.1	CNU3SML
IBM MQ Advanced	9.1.0.0, 9.1.1,0, 9.1.2.0	-
IBM WebSphere Application Server Liberty	16.0.0.3	Docker Hub image
{: caption="Table. Supported {{site.data.keyword.cloud_notm}} Private products to be used in {{site.data.keyword.cloud_notm}} Public." caption-side="top"}

Before you begin:

• Install the {{site.data.keyword.registryshort}} CLI plug-in (ibmcloud cr).
• Set up a namespace in {{site.data.keyword.registryshort}} or retrieve your existing namespace by running ibmcloud cr namespaces.
• Target your kubectl CLI to your cluster.
• Install the Helm CLI.

To deploy an {{site.data.keyword.cloud_notm}} Private image in a cluster in {{site.data.keyword.cloud_notm}} Public:

1. Follow the steps in the {{site.data.keyword.registryshort}} documentation to download the licensed software from IBM Passport Advantage, push the image to your namespace, and install the Helm chart in your cluster.

   For IBM WebSphere Application Server Liberty:

   1. Instead of obtaining the image from IBM Passport Advantage, use the Docker Hub image{: external}. For instructions on getting a production license, see Upgrading the image from Docker Hub to a production image{: external}.

   2. Follow the Liberty Helm chart instructions{: external}.

2. Verify that the STATUS of the Helm chart shows DEPLOYED. If not, wait a few minutes, and then try again.

   helm status <helm_chart_name>
   

   {: pre}

3. For more information about how to configure and use the product with your cluster, refer to the product-specific documentation.

   • IBM Db2 Direct Advanced Edition Server{: external}
   • IBM MQ Advanced{: external}
   • IBM WebSphere Application Server Liberty{: external}