Bug 1247291

None of the examples worked for me. I was able to change the configuration. 

Using the docs from 

https://github.com/GoogleCloudPlatform/kubernetes/blob/release-0.17/docs/services.md

Changing the endpoint configuration to look like this: 

# oc edit endpoints external-mysql-service


{
  "kind": "Endpoints",
  "apiVersion": "v1",
  "metadata": {
    "name": "external-mysql-service"
  },
"subsets": [
        {
            "addresses": [
                { "IP": "172.168.1.3" }
            ],
            "ports": [
                { "port": 3306 }
            ]
        }
    ]
}

Note that in the current version of the docs the service's spec.ports contains a name for the mysql port:

"ports": [
      {
        "name": "mysql",
        "protocol": "TCP",
        "port": 3306, ...


Then the endpoint definition seems to require a name too or it won't match, so it would be:

{
  "kind": "Endpoints",
  "apiVersion": "v1",
  "metadata": {
    "name": "external-mysql-service"
  },
  "subsets": [
        {
            "addresses": [
                { "IP": "172.168.1.3" }
            ],
            "ports": [
                { "port": 3306, "name": "mysql" }
            ]
        }
    ]
}

Ryan, Pep,

Some of this was approached in another recent BZ [1].

After reading through a lot of the stuff associated with this BZ, I'm pretty sure all that needed to happen was adding the "name" section to the endpoints example, which I've done. You can see the work here:

https://github.com/openshift/openshift-docs/pull/914

I believe creating and editing a service is presumed knowledge at this point in the docs. 

I'm also not too sure what you mean by the environment variables not being defined in the examples. I can see section, but the values would vary depending on the instance.

If there's anything more for this BZ, or if you disagree, please let me know. 

[1] https://bugzilla.redhat.com/show_bug.cgi?id=1255906

Ok. PR has merged. The shift in versions shouldn't be an issue. 

FYI, follow up BZ about creating services is here:

https://bugzilla.redhat.com/show_bug.cgi?id=1260486