diff --git a/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md b/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md index fe30006c6f..d8c66a4520 100644 --- a/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md +++ b/content/en/docs/concepts/extend-kubernetes/api-extension/custom-resources.md @@ -224,7 +224,7 @@ Aggregated API servers may or may not use the same authentication, authorization ## Accessing a custom resource -Kubernetes [client libraries](/docs/reference/client-libraries/) can be used to access custom resources. Not all client libraries support custom resources. The go and python client libraries do. +Kubernetes [client libraries](/docs/reference/using-api/client-libraries/) can be used to access custom resources. Not all client libraries support custom resources. The go and python client libraries do. When you add a custom resource, you can access it using: diff --git a/content/en/docs/concepts/overview/working-with-objects/kubernetes-objects.md b/content/en/docs/concepts/overview/working-with-objects/kubernetes-objects.md index 71f3f74be0..0962242625 100644 --- a/content/en/docs/concepts/overview/working-with-objects/kubernetes-objects.md +++ b/content/en/docs/concepts/overview/working-with-objects/kubernetes-objects.md @@ -18,7 +18,7 @@ This page explains how Kubernetes objects are represented in the Kubernetes API, A Kubernetes object is a "record of intent"--once you create the object, the Kubernetes system will constantly work to ensure that object exists. By creating an object, you're effectively telling the Kubernetes system what you want your cluster's workload to look like; this is your cluster's **desired state**. -To work with Kubernetes objects--whether to create, modify, or delete them--you'll need to use the [Kubernetes API](/docs/concepts/overview/kubernetes-api/). When you use the `kubectl` command-line interface, for example, the CLI makes the necessary Kubernetes API calls for you. You can also use the Kubernetes API directly in your own programs using one of the [Client Libraries](/docs/reference/client-libraries/). +To work with Kubernetes objects--whether to create, modify, or delete them--you'll need to use the [Kubernetes API](/docs/concepts/overview/kubernetes-api/). When you use the `kubectl` command-line interface, for example, the CLI makes the necessary Kubernetes API calls for you. You can also use the Kubernetes API directly in your own programs using one of the [Client Libraries](/docs/reference/using-api/client-libraries/). ### Object Spec and Status diff --git a/content/en/docs/getting-started-guides/clc.md b/content/en/docs/getting-started-guides/clc.md index e4792f40c8..69488fadc5 100644 --- a/content/en/docs/getting-started-guides/clc.md +++ b/content/en/docs/getting-started-guides/clc.md @@ -252,7 +252,7 @@ kubectl cluster-info ### Accessing the cluster programmatically -It's possible to use the locally stored client certificates to access the apiserver. For example, you may want to use any of the [Kubernetes API client libraries](/docs/reference/client-libraries/) to program against your Kubernetes cluster in the programming language of your choice. +It's possible to use the locally stored client certificates to access the apiserver. For example, you may want to use any of the [Kubernetes API client libraries](/docs/reference/using-api/client-libraries/) to program against your Kubernetes cluster in the programming language of your choice. To demonstrate how to use these locally stored certificates, we provide the following example of using ```curl``` to communicate to the master apiserver via https: diff --git a/content/en/docs/reference/_index.md b/content/en/docs/reference/_index.md index 493800506e..3926ed9a16 100644 --- a/content/en/docs/reference/_index.md +++ b/content/en/docs/reference/_index.md @@ -21,7 +21,7 @@ weight: 70 ## API Client Libraries To call the Kubernetes API from a programming language, you can use -[client libraries](/docs/reference/client-libraries/). Officially supported +[client libraries](/docs/reference/using-api/client-libraries/). Officially supported client libraries: - [Kubernetes Go client library](https://github.com/kubernetes/client-go/) diff --git a/content/en/docs/reference/using-api/api-overview.md b/content/en/docs/reference/using-api/api-overview.md index 27e0275c44..e20c7aaf7b 100644 --- a/content/en/docs/reference/using-api/api-overview.md +++ b/content/en/docs/reference/using-api/api-overview.md @@ -23,7 +23,7 @@ Most operations can be performed through the command-line tools, such as [kubeadm](/docs/reference/setup-tools/kubeadm/kubeadm/), which in turn use the API. However, you can also access the API directly using REST calls. -Consider using one of the [client libraries](/docs/reference/client-libraries/) +Consider using one of the [client libraries](/docs/reference/using-api/client-libraries/) if you are writing an application using the Kubernetes API. ## API versioning diff --git a/content/en/docs/tasks/access-application-cluster/access-cluster.md b/content/en/docs/tasks/access-application-cluster/access-cluster.md index 0f6963f207..062787551d 100644 --- a/content/en/docs/tasks/access-application-cluster/access-cluster.md +++ b/content/en/docs/tasks/access-application-cluster/access-cluster.md @@ -142,7 +142,7 @@ as the kubectl CLI does to locate and authenticate to the apiserver. See this [e #### Other languages -There are [client libraries](/docs/reference/client-libraries/) for accessing the API from other languages. +There are [client libraries](/docs/reference/using-api/client-libraries/) for accessing the API from other languages. See documentation for other libraries for how they authenticate. ### Accessing the API from a Pod diff --git a/content/en/docs/tasks/administer-cluster/access-cluster-api.md b/content/en/docs/tasks/administer-cluster/access-cluster-api.md index e49d488e2f..e05b459aeb 100644 --- a/content/en/docs/tasks/administer-cluster/access-cluster-api.md +++ b/content/en/docs/tasks/administer-cluster/access-cluster-api.md @@ -165,7 +165,7 @@ for i in ret.items: #### Other languages -There are [client libraries](/docs/reference/client-libraries/) for accessing the API from other languages. See documentation for other libraries for how they authenticate. +There are [client libraries](/docs/reference/using-api/client-libraries/) for accessing the API from other languages. See documentation for other libraries for how they authenticate. ### Accessing the API from a Pod @@ -173,7 +173,7 @@ When accessing the API from a Pod, locating and authenticating to the API server are somewhat different. The easiest way to use the Kubernetes API from a Pod is to use -one of the official [client libraries](/docs/reference/client-libraries/). These +one of the official [client libraries](/docs/reference/using-api/client-libraries/). These libraries can automatically discover the API server and authenticate. While running in a Pod, the Kubernetes apiserver is accessible via a Service named @@ -196,7 +196,7 @@ at `/var/run/secrets/kubernetes.io/serviceaccount/namespace` in each container. From within a Pod, the recommended ways to connect to the Kubernetes API are: - - Use one of the official [client libraries](/docs/reference/client-libraries/) + - Use one of the official [client libraries](/docs/reference/using-api/client-libraries/) as they handle API host discovery and authentication automatically. For Go client, the `rest.InClusterConfig()` function assists with this. See [an example here](https://git.k8s.io/client-go/examples/in-cluster-client-configuration/main.go). diff --git a/content/en/docs/user-journeys/users/application-developer/advanced.md b/content/en/docs/user-journeys/users/application-developer/advanced.md index 9bcd65440f..dde720f1b6 100644 --- a/content/en/docs/user-journeys/users/application-developer/advanced.md +++ b/content/en/docs/user-journeys/users/application-developer/advanced.md @@ -106,7 +106,7 @@ If you do not have a {{< glossary_tooltip text="cluster operator" term_id="clust The following topics are also useful for building more complex applications: * {{< link text="Other points of extensibility within Kubernetes" url="/docs/concepts/overview/extending/" >}} - A conceptual overview of where you can hook into the Kubernetes architecture. -* {{< link text="Kubernetes Client Libraries" url="/docs/reference/client-libraries/" >}} - Useful for building apps that need to interact heavily with the Kubernetes API. +* {{< link text="Kubernetes Client Libraries" url="/docs/reference/using-api/client-libraries/" >}} - Useful for building apps that need to interact heavily with the Kubernetes API. #### What's next Congrats on completing the Application Developer user journey! You've covered the majority of features that Kubernetes has to offer. What now?