Files
website/docs/tasks/access-kubernetes-api/http-proxy-access-api.md
T
Andrew Chen 2e257d9707 Changes for move to Netlify (#4464)
* disable jekyll-redirect-from gem

* add _redirects file

* disable 404 redirect script

* add 301 redirect to test

* retain _redirects file

* Convert redirect_from's to _redirect file. (#4409)

* Remove redirect_from's. (#4424)

* Add 301's to _redirects. (#4427)

* add whitespace before 301

* move redirects in /js/redirects/js to _redirects

* add disabled option for cn redirect

* convert include to array in _config.yml

* enable redirects.js script for legacy support
2017-07-28 08:23:11 -07:00

2.0 KiB

title
title
Use an HTTP Proxy to Access the Kubernetes API

{% capture overview %} This page shows how to use an HTTP proxy to access the Kubernetes API. {% endcapture %}

{% capture prerequisites %}

  • {% include task-tutorial-prereqs.md %}

  • If you do not already have an application running in your cluster, start a Hello world application by entering this command:

      kubectl run node-hello --image=gcr.io/google-samples/node-hello:1.0 --port=8080
    

{% endcapture %}

{% capture steps %}

Using kubectl to start a proxy server

This command starts a proxy to the Kubernetes API server:

kubectl proxy --port=8080

Exploring the Kubernetes API

When the proxy server is running, you can explore the API using curl, wget, or a browser.

Get the API versions:

curl http://localhost:8080/api/

{
  "kind": "APIVersions",
  "versions": [
    "v1"
  ],
  "serverAddressByClientCIDRs": [
    {
      "clientCIDR": "0.0.0.0/0",
      "serverAddress": "10.0.2.15:8443"
    }
  ]
}

Get a list of pods:

curl http://localhost:8080/api/v1/namespaces/default/pods

{
  "kind": "PodList",
  "apiVersion": "v1",
  "metadata": {
    "selfLink": "/api/v1/namespaces/default/pods",
    "resourceVersion": "33074"
  },
  "items": [
    {
      "metadata": {
        "name": "kubernetes-bootcamp-2321272333-ix8pt",
        "generateName": "kubernetes-bootcamp-2321272333-",
        "namespace": "default",
        "selfLink": "/api/v1/namespaces/default/pods/kubernetes-bootcamp-2321272333-ix8pt",
        "uid": "ba21457c-6b1d-11e6-85f7-1ef9f1dab92b",
        "resourceVersion": "33003",
        "creationTimestamp": "2016-08-25T23:43:30Z",
        "labels": {
          "pod-template-hash": "2321272333",
          "run": "kubernetes-bootcamp"
        },
        ...
}

{% endcapture %}

{% capture whatsnext %} Learn more about kubectl proxy. {% endcapture %}

{% include templates/task.md %}