-
Notifications
You must be signed in to change notification settings - Fork 105
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[gen-apidocs] remove standalone navdata, use DOM instead
- Loading branch information
Showing
11 changed files
with
210 additions
and
271 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,5 +1,5 @@ | ||
| <H1 id="-strong-cluster-apis-strong-"><strong>CLUSTER</strong></H1> | ||
| <DIV id="cluster-apis"> | ||
| <H1 class="toc-item section resource-category">Cluster</H1> | ||
|
|
||
| <P>Cluster resources are responsible for defining configuration of the cluster itself, and are generally only used by cluster operators.</P> | ||
|
|
||
| <HR /> | ||
| </DIV> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,3 +1,5 @@ | ||
| <H1 id="-strong-definitions-strong-"><STRONG>DEFINITIONS</STRONG></H1> | ||
| <DIV id="definitions"> | ||
| <H1 class="toc-item section">Definitions</H1> | ||
|
|
||
| <P>This section contains definitions for objects used in the Kubernetes APIs.</P> | ||
| </DIV> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,3 +1,5 @@ | ||
| <H1 id="-strong-old-api-versions-strong-"><STRONG>OLD API VERSIONS</STRONG></H1> | ||
| <DIV id="old-api-versions"> | ||
| <H1 class="toc-item section" id="">Old API Versions</H1> | ||
|
|
||
| <P>This section contains older versions of resources shown above.</P> | ||
| </DIV> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,88 +1,85 @@ | ||
| <H1 id="-strong-api-overview-strong-"><STRONG>API OVERVIEW</STRONG></H1> | ||
| <DIV id="api-overview"> | ||
| <H1 class="toc-item section">API Overview</H1> | ||
|
|
||
| <P>Welcome to the Kubernetes API. You can use the Kubernetes API to read | ||
| <P>Welcome to the Kubernetes API. You can use the Kubernetes API to read | ||
| and write Kubernetes resource objects via a Kubernetes API endpoint.</P> | ||
|
|
||
| <H2 id="resource-categories">Resource Categories</H2> | ||
|
|
||
| <P>This is a high-level overview of the basic types of resources provide by the Kubernetes API and their primary functions.</P> | ||
| <P><B>Workloads</B> are objects you use to manage and run your containers on the cluster.</P> | ||
| <P><B>Discovery & LB</B> resources are objects you use to "stitch" your workloads together into an externally accessible, load-balanced Service.</P> | ||
| <P><B>Config & Storage</B> resources are objects you use to inject initialization data into your applications, and to persist data that is external to your container.</P> | ||
| <P><B>Cluster</B> resources objects define how the cluster itself is configured; these are typically used only by cluster operators.</P> | ||
| <P><B>Metadata</B> resources are objects you use to configure the behavior of other resources within the cluster, such as <code>HorizontalPodAutoscaler</code> for scaling workloads.</P> | ||
|
|
||
| <HR /> | ||
| <P><STRONG>Workloads</STRONG> are objects you use to manage and run your containers on the cluster.</P> | ||
| <P><STRONG>Discovery & LB</STRONG> resources are objects you use to "stitch" your workloads together into an externally accessible, load-balanced Service.</P> | ||
| <P><STRONG>Config & Storage</STRONG> resources are objects you use to inject initialization data into your applications, and to persist data that is external to your container.</P> | ||
| <P><STRONG>Cluster</STRONG> resources objects define how the cluster itself is configured; these are typically used only by cluster operators.</P> | ||
| <P><STRONG>Metadata</STRONG> resources are objects you use to configure the behavior of other resources within the cluster, such as <code>HorizontalPodAutoscaler</code> for scaling workloads.</P> | ||
|
|
||
| <H2 id="resource-objects">Resource Objects</H2> | ||
|
|
||
| <P>Resource objects typically have 3 components:</P> | ||
| <UL> | ||
| <LI><B>Resource ObjectMeta</B>: This is metadata about the resource, such as its name, type, api version, annotations, and labels. This contains | ||
| <LI><STRONG>Resource ObjectMeta</STRONG>: This is metadata about the resource, such as its name, type, api version, annotations, and labels. This contains | ||
| fields that maybe updated both by the end user and the system (e.g. annotations).</LI> | ||
| <LI><B>ResourceSpec</B>: This is defined by the user and describes the desired state of system. Fill this in when creating or updating an object.</LI> | ||
| <LI><B>ResourceStatus</B>: This is filled in by the server and reports the current state of the system. In most cases, users don't need to change this.</LI> | ||
| <LI><STRONG>ResourceSpec</STRONG>: This is defined by the user and describes the desired state of system. Fill this in when creating or updating an object.</LI> | ||
| <LI><STRONG>ResourceStatus</STRONG>: This is filled in by the server and reports the current state of the system. In most cases, users don't need to change this.</LI> | ||
| </UL> | ||
|
|
||
| <HR /> | ||
|
|
||
| <H2 id="resource-operations">Resource Operations</H2> | ||
|
|
||
| <P>Most resources provide the following Operations:</P> | ||
|
|
||
| <H4 id="resource-operations-create">Create</H4> | ||
|
|
||
| <P>Create operations will create the resource in the storage backend. After a resource is create the system will apply | ||
| <P>Create operations will create the resource in the storage backend. After a resource is create the system will apply | ||
| the desired state.</P> | ||
|
|
||
| <H4 id="resource-operations-update">Update</H4> | ||
|
|
||
| <P>Updates come in 2 forms: <B>Replace</B> and <B>Patch</B>: | ||
| <P>Updates come in 2 forms: <STRONG>Replace</STRONG> and <STRONG>Patch</STRONG>: | ||
|
|
||
| <UL> | ||
| <LI><B>Replace</B>: | ||
| Replacing a resource object will update the resource by replacing the existing spec with the provided one. For | ||
| <LI><STRONG>Replace</STRONG>: | ||
| Replacing a resource object will update the resource by replacing the existing spec with the provided one. For | ||
| read-then-write operations this is safe because an optimistic lock failure will occur if the resource was modified | ||
| between the read and write. <I>Note</I>: The <I>ResourceStatus</I> will be ignored by the system and will not be updated. | ||
| between the read and write. <EM>Note</EM>: The <EM>ResourceStatus</EM> will be ignored by the system and will not be updated. | ||
| To update the status, one must invoke the specific status update operation.<BR /> | ||
|
|
||
| Note: Replacing a resource object may not result immediately in changes being propagated to downstream objects. For instance | ||
| replacing a <CODE>ConfigMap</CODE> or <CODE>Secret</CODE> resource will not result in all <I>Pod</I>s seeing the changes unless the <I>Pod</I>s are | ||
| Note: Replacing a resource object may not result immediately in changes being propagated to downstream objects. For instance | ||
| replacing a <CODE>ConfigMap</CODE> or <CODE>Secret</CODE> resource will not result in all <EM>Pod</EM>s seeing the changes unless the <EM>Pod</EM>s are | ||
| restarted out of band.</P></LI> | ||
|
|
||
| <LI><B>Patch</B>: | ||
| Patch will apply a change to a specific field. How the change is merged is defined per field. Lists may either be | ||
| replaced or merged. Merging lists will not preserve ordering.<BR /> | ||
| <LI><STRONG>Patch</STRONG>: | ||
| Patch will apply a change to a specific field. How the change is merged is defined per field. Lists may either be | ||
| replaced or merged. Merging lists will not preserve ordering.<BR /> | ||
|
|
||
| <B>Patches will never cause optimistic locking failures, and the last write will win.</B> Patches are recommended | ||
| when the full state is not read before an update, or when failing on optimistic locking is undesirable. <I>When patching | ||
| <STRONG>Patches will never cause optimistic locking failures, and the last write will win.</STRONG> Patches are recommended | ||
| when the full state is not read before an update, or when failing on optimistic locking is undesirable. <EM>When patching | ||
| complex types, arrays and maps, how the patch is applied is defined on a per-field basis and may either replace | ||
| the field's current value, or merge the contents into the current value.</I></LI> | ||
| the field's current value, or merge the contents into the current value.</EM></LI> | ||
| </UL> | ||
|
|
||
| <H4 id="resource-operations-read">Read</H4> | ||
|
|
||
| <P>Reads come in 3 forms: <B>Get</B>, <B>List</B> and <B>Watch</B>:<P> | ||
| <P>Reads come in 3 forms: <STRONG>Get</STRONG>, <STRONG>List</STRONG> and <STRONG>Watch</STRONG>:</P> | ||
|
|
||
| <UL> | ||
| <LI><B>Get</B>: Get will retrieve a specific resource object by name.</LI> | ||
| <LI><B>List</B>: List will retrieve all resource objects of a specific type within a namespace, and the results can be restricted to resources matching a selector query.<BR /> | ||
| <B>List All Namespaces</B>: Like <B>List</B> but retrieves resources across all namespaces.</LI> | ||
| <LI><B>Watch</B>: Watch will stream results for an object(s) as it is updated. Similar to a callback, watch is used to respond to resource changes.</LI> | ||
| <LI><STRONG>Get</STRONG>: Get will retrieve a specific resource object by name.</LI> | ||
| <LI><STRONG>List</STRONG>: List will retrieve all resource objects of a specific type within a namespace, and the results can be restricted to resources matching a selector query.<BR /> | ||
| <STRONG>List All Namespaces</STRONG>: Like <STRONG>List</STRONG> but retrieves resources across all namespaces.</LI> | ||
| <LI><STRONG>Watch</STRONG>: Watch will stream results for an object(s) as it is updated. Similar to a callback, watch is used to respond to resource changes.</LI> | ||
| </UL> | ||
|
|
||
| <H4 id="resource-operations-read">Delete</H4> | ||
|
|
||
| <P>Delete will delete a resource. Depending on the specific resource, child objects may or may not be garbage collected by the server. See | ||
| <P>Delete will delete a resource. Depending on the specific resource, child objects may or may not be garbage collected by the server. See | ||
| notes on specific resource objects for details.</P> | ||
|
|
||
| <H4 id="resource-operations-additional">Additional Operations</H4> | ||
|
|
||
| <P>Resources may define additional operations specific to that resource type.</P> | ||
|
|
||
| <UL> | ||
| <LI><B>Rollback</B>: Rollback a PodTemplate to a previous version. Only available for some resource types.</LI> | ||
| <LI><B>Read / Write Scale</B>: Read or Update the number of replicas for the given resource. Only available for some resource types.</LI> | ||
| <LI><B>Read / Write Status</B>: Read or Update the Status for a resource object. The Status can only changed through these update operations.</LI> | ||
| <LI><STRONG>Rollback</STRONG>: Rollback a PodTemplate to a previous version. Only available for some resource types.</LI> | ||
| <LI><STRONG>Read / Write Scale</STRONG>: Read or Update the number of replicas for the given resource. Only available for some resource types.</LI> | ||
| <LI><STRONG>Read / Write Status</STRONG>: Read or Update the Status for a resource object. The Status can only changed through these update operations.</LI> | ||
| </UL> | ||
| <HR /> | ||
| </DIV> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.