Skip to content

LKE Beta Endpoints #126

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 32 commits into from
Nov 15, 2019
Merged

Conversation

leslitagordita
Copy link
Contributor

@leslitagordita leslitagordita commented Sep 16, 2019

  • Adds LKE Beta endpoints:
    • /lke/clusters
    • /lke/clusters/{clusterId}
    • /lke/clusters/{clusterId}/pools
    • /lke/clusters/{clusterId}/pools/{poolId}
    • /lke/clusters/{clusterId}/kubeconfig
    • /lke/versions
    • /lke/versions/{version}

Note: This work was started by @asauber and @jfrederickson in bits repo. This adds latest updates to that worki.

leslitagordita and others added 9 commits September 16, 2019 15:47
This will help a user know what LKE refers to if
used within any endpoint descriptions.
…ub.com:leslitagordita/linode-api-docs into lke-add-endpoints
Add reference to LKENodePool and LKENodePoolRequestBody
to POST endpoint.

Remove `node_pools` property from LKECluster and
LKEClusterRequestBody
@hzoppetti
Copy link
Contributor

please add:
lke:read_only
lke:read_write
to the oauth schema section and to the front information section

openapi.yaml Outdated
content:
application/json:
schema:
$ref: '#/components/schemas/LKENodePoolRequestBody'
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think both type and count need to be required here see lines 312-318 of apinext/apinext/blueprints/beta/lke_clusters.py

@hzoppetti
Copy link
Contributor

A general note for beta - LKE is available in us-central and with Kubernetes version 1.16, these should be updated in the examples.

openapi.yaml Outdated
type: object
properties:
count:
allOf:
Copy link
Contributor

@hzoppetti hzoppetti Nov 12, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe this needs to be required.

@hzoppetti
Copy link
Contributor

Additionally we want to add a link to the beta sign up page with the beta note.

@hzoppetti hzoppetti changed the title [Do Not Merge] LKE Beta Endpoints LKE Beta Endpoints Nov 14, 2019
@hzoppetti hzoppetti requested review from michaelsaah and jnschaeffer and removed request for michaelsaah November 14, 2019 16:19
openapi.yaml Outdated
version:
type: string
description: >
The desired Kubernetes version for this Kubernetes cluster.
Copy link
Contributor

@asauber asauber Nov 15, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could add, "In the format of <major>.<minor>, and the latest supported patch version will be deployed"

openapi.yaml Outdated
tags:
type: array
description: >
An array of tags applied to the Kubernetes cluster and _all
Copy link
Contributor

@asauber asauber Nov 15, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The "and all resources created by the Kubernetes cluster (such as NodeBalancers and Volumes)." part of this is not currently deployed and is still an open design question. It may become a new field. My suggestion is to remove it here.

description: >
A Kubernetes version number available for deployment
to a Kubernetes cluster.
example: "1.16"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The curl example response for this one should use this string rather than show an integer 1234

Copy link
Contributor

@asauber asauber left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great.

There are a few instances of refs breaking the examples or nested object descriptions, and IDs showing as empty strings, which we are aware of.

@hzoppetti hzoppetti merged commit f0df0ac into linode:development Nov 15, 2019
LBGarber pushed a commit to LBGarber/linode-api-docs that referenced this pull request Jun 15, 2022
LBGarber pushed a commit to LBGarber/linode-api-docs that referenced this pull request Jun 15, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants