Skip to content

Latest commit

 

History

History
175 lines (151 loc) · 5.93 KB

cs_loadbalancer_qs.md

File metadata and controls

175 lines (151 loc) · 5.93 KB
Raw
copyright lastupdated keywords subcollection
years
2014, 2021
2021-03-22
kubernetes, iks, nlb, lbaas
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}

Quick start for load balancers

{: #loadbalancer-qs}

Quickly expose your app to the Internet by creating a layer 4 load balancer. {: shortdesc}

First time setting up a load balancer? Check out Classic: Setting up basic load balancing with an NLB 1.0 or VPC: Exposing apps with VPC load balancers for prerequisite steps, limitations, and more details. Come back to these quick start steps for a brief refresher the next time you set up a load balancer. {: tip}

Exposing an app by using an NLB in a classic cluster

{: #lb_qs_classic}

  1. Expose your app by creating a version 1.0 network load balancer (NLB 1.0).
kubectl expose deploy my-app --port=80 --target-port=8080 --type=LoadBalancer --name my-lb-svc

{: pre}

  1. Get the NLB 1.0 EXTERNAL-IP address.
kubectl get svc my-lb-svc

{: pre}

Example output:

NAME        TYPE           CLUSTER-IP      EXTERNAL-IP     PORT(S)        AGE
my-lb-svc   LoadBalancer   172.XX.XXX.XX   169.XX.XXX.XX   80:31224/TCP   23s

{: screen}

  1. Curl your app's IP address.
curl <external-ip>

{: pre}

  1. Optional: Create a hostname for your app.
ibmcloud ks nlb-dns create classic -c <cluster_name_or_id> --ip <NLB_IP>

{: pre}

In a web browser, enter the hostname that is created. Example output:

NLB hostname was created as mycluster-35366fb2d3d90fd50548180f69e7d12a-0001.us-south.containers.appdomain.cloud

{: screen}

For more information, see:

Exposing an app by using a VPC load balancer in a VPC cluster

{: #lb_qs_vpc}

  1. Expose your app by creating a Kubernetes LoadBalancer service.
kubectl expose deploy my-app --port=80 --target-port=8080 --type=LoadBalancer --name my-lb-svc

{: pre}

  1. Get the service's hostname that is listed in the EXTERNAL-IP column. The VPC load balancer that assigns the hostname takes a few minutes to provision in your VPC. You cannot access your app by using the hostname of your Kubernetes LoadBalancer service until the VPC load balancer is fully provisioned.
kubectl get svc my-lb-svc

{: pre}

Example output:

NAME        TYPE           CLUSTER-IP      EXTERNAL-IP                            PORT(S)        AGE
my-lb-svc   LoadBalancer   172.XX.XXX.XX   1234abcd-us-south.lb.appdomain.cloud   80:31224/TCP   23s

{: screen}

  1. In a web browser, enter the hostname that is created.

For more information, see VPC: Exposing apps with VPC load balancers.