KEP-706keps/sig-apps/706-portable-service-definitions

Portable Service Definitions

provisionalsig-apps1 open finding

KEP on GitHub kep.yaml Ask about this KEP

The goal of this feature is to enable an application to be deployed into multiple environments while relying on external services that are not part of the application and using the same objects in all environments. That includes service instances that may or may not be managed by Kubernetes. For example, take a WordPress application that relies on MySQL. If the application is running in GKE or AKS it may leverage a Google or Azure MySQL as a Service. If it is running in Minikube or in a bare metal cluster it may use MySQL managed by the Kubernetes cluster. In all of these cases, the same resource is declared asking for the service (e.g., MySQL) and the credentials to use the service are returned in a common manner (e.g., a secret with the same type and schema). This enables portability from one environment to another because working with services in all environments leverages the same Kubernetes objects with the same schemas.

Facts

Authors: @mattfarina
Approvers: @prydonius @mattfarina @kow3ns
Reviewers: @carolynvs @prydonius @kow3ns @jboyd01 @duglin @kibbles-n-bytes
PRR approvers: none
Tracking issue: #706(opens GitHub in a new tab) closedcompletedclosed 2020-05-08 18:03 UTCsig/apps
Milestones: none
Participating SIGs: none
Feature gates: none
Created / last updated: 2018-11-13 / 2018-11-19

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2020-12-17 19:39 UTC	status_transition KEP-706 status set to provisional in PR #2196, approved by johnbelamaric; merged by automation (k8s-ci-robot) on 2020-12-17.	@wojtek-t author @johnbelamaric approve_command @johnbelamaric lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@5f128c7d78b27f56569f0e8a63178c746323497f(opens GitHub in a new tab) StatusChange status ∅ → provisional (2020-12-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2196 Migrate some apps KEPs to new template(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/747653854(opens GitHub in a new tab)

Metadata, label and milestone changes, oldest first.Showing 1–10 of 14Rows

Status history
At	Kind	Field	Change	Actor	Evidence
2019-01-20 22:24 UTC	label	needs-sig added	none → needs-sig	@k8s-ci-robot	source(opens GitHub in a new tab)
2019-01-21 09:07 UTC	label	sig/apps added	none → sig/apps	@k8s-ci-robot	source

Relationships as stored, Person → KEP, from kep.yaml(opens GitHub in a new tab)
Person	Relationship
@mattfarina GitHub(opens GitHub in a new tab)	—AUTHORED→
@carolynvs GitHub(opens GitHub in a new tab)	—REVIEWS→
@prydonius GitHub(opens GitHub in a new tab)	—REVIEWS→
@kow3ns

How they connect

Shortest paths in the graph between this KEP and its SIG or one of its people, up to four hops.

Impact of change

Rows returned by the tool
Kep	Depth	Reached	By hop	Open pull requests	Hop	Sigs	People
{ "label": "KEP", "key": "keps/sig-apps/706-portable-service-definitions", "title": "Portable Service Definitions", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/706-portable-service-definitions", "evidence_id": "4p2ogrbnln3z", "number": 706, "owning_sig": "sig-apps", "status": "provisional", "creation_date": "2018-11-13", "last_updated": "2018-11-19", "metadata_invalid": false }	2	4	{ "1": { "sigs": 1, "people": 3 } }	not in graph (merged pull requests only)	none	none	none
none	none	none	none	none	1	[ { "label": "SIG", "key": "sig-apps", "title": "Apps", "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-apps", "evidence_id": "3xevdpgexdfq", "display_name": "Apps", "sig_label": "apps", "in_scope": true } ]	[ { "label": "Person", "key": "mattfarina", "title": "mattfarina", "url": "https://github.com/mattfarina", "evidence_id": "gzcmr5dbbzn6", "login": "mattfarina", "is_bot": false }, { "label": "Person", "key": "prydonius", "title": "prydonius", "url": "https://github.com/prydonius", "evidence_id": "q2ygjd53tgxr", "login": "prydonius", "is_bot": false }, { "label": "Person", "key": "kow3ns", "title": "kow3ns", "url": "https://github.com/kow3ns", "evidence_id": "z26v6kilqc4a", "login": "kow3ns", "is_bot": false } ]

Rows returned by the tool
Kep	Depth	Reached	By hop	Open pull requests	Hop	Sigs	People
{ "label": "KEP", "key": "keps/sig-apps/706-portable-service-definitions", "title": "Portable Service Definitions", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/706-portable-service-definitions", "evidence_id": "4p2ogrbnln3z", "number": 706, "owning_sig": "sig-apps", "status": "provisional", "creation_date": "2018-11-13", "last_updated": "2018-11-19", "metadata_invalid": false }	2	4	{ "1": { "sigs": 1, "people": 3 } }	not in graph (merged pull requests only)	none	none	none
none	none	none	none	none	1	[ { "label": "SIG", "key": "sig-apps", "title": "Apps", "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-apps", "evidence_id": "3xevdpgexdfq", "display_name": "Apps", "sig_label": "apps", "in_scope": true } ]	[ { "label": "Person", "key": "mattfarina", "title": "mattfarina", "url": "https://github.com/mattfarina", "evidence_id": "gzcmr5dbbzn6", "login": "mattfarina", "is_bot": false }, { "label": "Person", "key": "prydonius", "title": "prydonius", "url": "https://github.com/prydonius", "evidence_id": "q2ygjd53tgxr", "login": "prydonius", "is_bot": false }, { "label": "Person", "key": "kow3ns", "title": "kow3ns", "url": "https://github.com/kow3ns", "evidence_id": "z26v6kilqc4a", "login": "kow3ns", "is_bot": false } ]

Kep

Depth

Reached

By hop

Open pull requests

Hop

Sigs

People

{
  "label": "KEP",
  "key": "keps/sig-apps/706-portable-service-definitions",
  "title": "Portable Service Definitions",
  "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/706-portable-service-definitions",
  "evidence_id": "4p2ogrbnln3z",
  "number": 706,
  "owning_sig": "sig-apps",
  "status": "provisional",
  "creation_date": "2018-11-13",
  "last_updated": "2018-11-19",
  "metadata_invalid": false
}

{
  "1": {
    "sigs": 1,
    "people": 3
  }
}

not in graph (merged pull requests only)

[
  {
    "label": "SIG",
    "key": "sig-apps",
    "title": "Apps",
    "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-apps",
    "evidence_id": "3xevdpgexdfq",
    "display_name": "Apps",
    "sig_label": "apps",
    "in_scope": true
  }
]

[
  {
    "label": "Person",
    "key": "mattfarina",
    "title": "mattfarina",
    "url": "https://github.com/mattfarina",
    "evidence_id": "gzcmr5dbbzn6",
    "login": "mattfarina",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "prydonius",
    "title": "prydonius",
    "url": "https://github.com/prydonius",
    "evidence_id": "q2ygjd53tgxr",
    "login": "prydonius",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "kow3ns",
    "title": "kow3ns",
    "url": "https://github.com/kow3ns",
    "evidence_id": "z26v6kilqc4a",
    "login": "kow3ns",
    "is_bot": false
  }
]

MATCH (k:KEP {key: $key}) RETURN k LIMIT 1 ; MATCH (k:KEP {key: $key}) MATCH path = (k)-[:REPLACES|SUPERSEDED_BY|SEE_ALSO|GATED_BY*1..2]-(n) WHERE n <> k AND (n:KEP OR n:FeatureGate) AND all(x IN nodes(path)[1..-1] WHERE x <> k AND (x:KEP OR (x:FeatureGate AND NOT x.key IN $placeholders))) WITH n, path ORDER BY length(path), [x IN nodes(path) | x.key] WITH n, collect(path)[0] AS path RETURN n AS node, length(path) AS hop, path ORDER BY hop, n.key LIMIT 150 ; UNWIND $keys AS kk MATCH (k:KEP {key: kk}) RETURN k.key AS kep, [(k)-[r_0:OWNED_BY]->(s_0:SIG) WHERE coalesce(r_0.valid_to, $open) = $open | s_0] AS sigs, [(p_1:Person)-[r_1:AUTHORED]->(k) WHERE coalesce(r_1.valid_to, $open) = $open AND coalesce(p_1.is_bot, false) = false | p_1] AS authors, [(p_2:Person)-[r_2:APPROVES]->(k) WHERE coalesce(r_2.valid_to, $open) = $open AND coalesce(p_2.is_bot, false) = false | p_2] AS approvers, [(k)-[r_3:TRACKED_BY]->(i_3:Issue) WHERE coalesce(r_3.valid_to, $open) = $open AND i_3.state = 'open' | i_3] AS open_issues LIMIT 200

Portable Service Definitions

Facts

How they connect

Impact of change

Keyboard shortcuts

Everywhere

Go to a page

Ask

Search lists

KEP page

Findings table

How they connect

Impact of change

Hop 1

Impact of change

Impact of change

Hop 1