Commit Graph

609 Commits

Author SHA1 Message Date
lsowen c561bdc52f Fix typo in link (lables.md -> labels.md) 2017-08-16 09:32:10 -04:00
Kubernetes Submit Queue 74d0e211f4 Merge pull request #3193 from orrchen/master
Automatic merge from submit-queue

resolve #3169
2017-08-14 06:14:00 -07:00
Kubernetes Submit Queue b7331ac23e Merge pull request #2992 from itskingori/node_resource_handling
Automatic merge from submit-queue

Add documentation on handling node resources

At a minimum, this is meant to give more context on why the feature in https://github.com/kubernetes/kops/pull/2982 was added and attempts to give some recommendations of what to consider when evaluating node system resources.

I hope this spurs some discussion and that the recommendations I make maybe be assessed further. For example ... in one of the links I referenced, we're advised to set `system-reserved` **only if we know what we are doing** (which I can't say I do 💯% ... 🤷‍♂️) and we're even warned to only set it if you really need to.
2017-08-14 05:28:28 -07:00
Orr Chen 43020af959 resolve #3169 2017-08-13 19:16:22 +03:00
King'ori Maina 1bd329ad93
Avoid fuzzy language 2017-08-12 21:18:16 +02:00
King'ori Maina 14359657c0
Prefer to wrap text
Line-breaks makes it easier for reviews, especially Github commenting.
2017-08-12 21:17:10 +02:00
Rohith 7f5c83e417 Requests Changes - Hooks Enhancement
- switched to using an array of roles rather than boolean flags for node selection
- fixed up the README to reflect the changes
- added the docker.service as a Requires to all docker exec hooks
2017-08-11 12:41:08 +01:00
Rohith 0bfc2f1b24 Hooks in InstanceGroups
- extending the hooks to permit adding hooks per instancegroup as well
- @note, instanceGroup are permitted to override the cluster wide one for ease of testing
- updated the documentation to reflect the changes
- on the journey tried to fix an go idioms such as import ordering, comments for global export etc
- @question: v1alpha1 doesn't appear to have Subnet fields, are these different version being used anywhere?
2017-08-11 12:40:10 +01:00
Rohith 153db84df1 Custom Manifests via Hooks
The present implementation of hooks only perform for docker exec, which isn't that flexible. This PR permits the user to greater customize systemd units on the instances

- cleaned up the manifest code, added tests and permit setting a section raw
- added the ability to filter hooks via master and node roles
- updated the documentation to reflect the changes
- cleaned up some of the vetting issues
2017-08-11 12:40:10 +01:00
Rohith fe3dd9815c Cluster Hook Ordering
The current implementation does not permit the user to order the hooks. This PR adds optional Requires, Before and Documentation to the HookSpec which is added the systemd unit if specified.
2017-08-11 12:40:10 +01:00
Kubernetes Submit Queue b418c3036d Merge pull request #3125 from gambol99/kubelet_api
Automatic merge from submit-queue

Kubelet API Certificate

A while back options to permit secure kube-apiserver to kubelet api was [PR2381](https://github.com/kubernetes/kops/pull/2831) using the server.cert and server.key as testing grounds. This PR formalizes the options and generates a client certificate on their behalf (note, the server{.cert,key} can no longer be used post 1.7 as the certificate usage is checked i.e. it's not using a client cert). The users now only need to add anonymousAuth: false to enable secure api to kubelet. I'd like to make this default to all new builds i'm not sure where to place it.

- updated the security.md to reflect the changes
- issue a new client kubelet-api certificate used to secure authorize comms between api and kubelet
- fixed any formatting issues i came across on the journey
2017-08-11 02:41:14 -07:00
Kubernetes Submit Queue b1aee7a505 Merge pull request #2542 from kenden/patch-1
Automatic merge from submit-queue

Clarify docs: rename spec/specification into desired configuration 

The cluster state in S3 has (among others) two files: `cluster.spec` and `config`.
When the documentation mentioned "create or update cluster spec" for example, it was confusing what was actually updated. It's not the cluster.spec file.
As I understand, `cluster.spec` should only be created/updated after `kops update --yes` is run.

I changed the docs for `kops get`, `kops create`, `kops replace`, `kops edit`.
I did NOT change those files: `kops_rolling-update.md`, `kops_rolling-update_cluster.md` as I think those actually use `cluster.spec`.
2017-08-10 21:37:29 -07:00
Quentin Nerden 5491f179d1 Clarify docs: rename spec to desired conf
In the S3 bucket, the file cluster.spec is not actually the spec, but the
actual configuration. The file config is the spec. To avoid confusion,
this commit changes spec/specification into 'desired configuration' in
the documentation, to avoid associating cluster.spec with a cluster
'specification' that the users should use.
2017-08-10 18:50:45 +02:00
Nathan Smith 3e24cef79f Specify initial period in gossip-based cluster name pattern 2017-08-09 14:26:08 -07:00
Rohith 9873fc1be5 Requested Changes
- fixed the various issues highlighted in https://github.com/kubernetes/kops/pull/3125
- changed the docuementation to make more sense
- changed the logic of the UseSecureKubelet to return early
2017-08-08 13:47:08 +01:00
asifdxtreme 65e48b553a Update the docs 2017-08-08 11:03:38 +08:00
Rohith 2fb60b9b3d Kubelet API Certificate
A while back options to permit secure kube-apiserver to kubelet api was https://github.com/kubernetes/kops/pull/2831 using the server.cert and server.key as testing grouns. This PR formalizes the options and generates a client certificate on their behalf (note, the server{.cert,key} can no longer be used post 1.7 as the certificate usage is checked i.e. it's not using a client cert). The users now only need to add anonymousAuth: false to enable secure api to kubelet. I'd like to make this default to all new builds i'm not sure where to place it.

- updated the security.md to reflect the changes
- issue a new client kubelet-api certificate used to secure authorize comms between api and kubelet
- fixed any formatting issues i came across on the journey
2017-08-08 01:11:09 +01:00
Derek VerLee ffa95b8112 Add support for cluster using http forward proxy 2017-08-07 14:30:42 -04:00
Rohith 3599e64205 - fixing up the flag name from --create to --force to make it align to the kubectl syntax 2017-08-04 20:44:49 +01:00
Rohith 70144d1b88 - updated the generated documentation with the new cli option 2017-08-04 20:44:49 +01:00
Kubernetes Submit Queue 10ce978b64 Merge pull request #3040 from mad01/templating
Automatic merge from submit-queue

MVP of templating 

MVP implementation of templating to generate cluster.yaml file: related to #2404 implementation is using the `text/template`

```bash
cat > values.yaml <<EOF
clusterName: eu1
kubernetesVersion: 1.7.1
dnsZone: k8s.example.com
awsRegion: eu-west-1
EOF
```

```bash
cat > cluster.tmpl.yaml <<EOF
apiVersion: kops/v1alpha2
kind: InstanceGroup
metadata:
  labels:
	kops.k8s.io/cluster: {{.clusterName}}.{{.dnsZone}}
  name: nodes
spec:
  image: coreos.com/CoreOS-stable-1409.6.0-hvm
  machineType: m4.large
  maxPrice: "0.5"
  maxSize: 2
  minSize: 15
  role: Node
  rootVolumeSize: 100
  subnets:
  - {{.awsRegion}}a
  - {{.awsRegion}}b
  - {{.awsRegion}}c

EOF
```

running the templating command
```bash
  kops toolbox template \
      --values values.yaml \
      --template cluster.tmpl.yaml \
      --output cluster.yaml
```

output
```bash
apiVersion: kops/v1alpha2
kind: InstanceGroup
metadata:
  labels:
	kops.k8s.io/cluster: eu1.k8s.example.com
  name: nodes
spec:
  image: coreos.com/CoreOS-stable-1409.6.0-hvm
  machineType: m4.large
  maxPrice: "0.5"
  maxSize: 2
  minSize: 15
  role: Node
  rootVolumeSize: 100
  subnets:
  - eu-west-1a
  - eu-west-1b
  - eu-west-1c
```
2017-08-04 09:26:41 -07:00
Sathiya Shunmugasundaram d92ea22ecd Update aws.md
SSH key pair must be available before creating the cluster, adding the instructions.
2017-08-04 09:48:42 -04:00
Kubernetes Submit Queue f123a95236 Merge pull request #3075 from Globegitter/patch-2
Automatic merge from submit-queue

Add k8s dashbard v1.6.2
2017-08-03 23:16:30 -07:00
Kubernetes Submit Queue 5153ed5cf7 Merge pull request #3116 from gekart/patch-1
Automatic merge from submit-queue

added missing command in documentation

Documentation correction.
2017-08-03 22:42:18 -07:00
Kubernetes Submit Queue 5577fab602 Merge pull request #3087 from blakebarnett/bdb/add_node_docker_config_secret
Automatic merge from submit-queue

Add `kops create secret dockerconfig` feature

This adds a well-known secret name `dockerconfig` which will automatically
be used if present to create `/root/.docker/config.json` on all nodes. This will
allow private registries to be used for kops hooks as well as any k8s images
without the need to define `imagePullSecrets` in every namespace.

closes https://github.com/kubernetes/kops/issues/2505
2017-08-03 19:33:42 -07:00
Kubernetes Submit Queue bc47b748f2 Merge pull request #3095 from msvbhat/docs-topology-command-fix
Automatic merge from submit-queue

docs/topology - Fix the rolling-update command

This patch updates the `kops rolling-update` command which should be
run after making changes to the API server topology.

Fixes #3093 

Signed-off-by: M S Vishwanath Bhat <msvbhat@gmail.com>
2017-08-02 23:45:29 -07:00
Grischa Ekart 04ffccf60f added missing command 2017-08-02 16:08:38 +02:00
Kubernetes Submit Queue 366f38b1f9 Merge pull request #3107 from murali-reddy/kube-router-doc
Automatic merge from submit-queue

remove source/destination check requirement for kube-router from docs

Kube-router automatically disables source/destination checks for the AWS
EC2 instances now user need not perform explicitly.

Fixed as part of https://github.com/cloudnativelabs/kube-router/issues/35
2017-08-01 22:15:11 -07:00
Kubernetes Submit Queue 58e0074e8d Merge pull request #3108 from DevipriyaSarkar/patch-1
Automatic merge from submit-queue

Update update_kops.md
2017-08-01 21:04:52 -07:00
Blake 4f95fe473f Incorporate review feedback
- Rename to just DockerConfig / dockerconfig everywhere for consistency
- Check if the config is valid JSON
- Update docs
2017-08-01 13:15:19 -07:00
Kubernetes Submit Queue 576dca6fb7 Merge pull request #3102 from yoz2326/aws_ebs_iops
Automatic merge from submit-queue

AWS: root volume provisioned IOPS support

It is possible to set `rootVolumeType: gp2` so an instance group will use `gp2` as disk type (https://github.com/kubernetes/kops/blob/master/docs/instance_groups.md)

If the option is set to `rootVolumeType: io1` then the below error is thrown when building the cluster:

`W0731 13:44:44.298875    8784 executor.go:109] error running task "LaunchConfiguration/master-eu-west-1a.masters.cluster.name" (9m48s remaining to succeed): error creating AutoscalingLaunchConfiguration: ValidationError: Iops is required for a provisioned IOPS volume.
    status code: 400, request id: 072e23b2-75ee-11e7-968a-191d6f6e9343`

This PR tries to address this so if anyone needs, it can use `io1` as disk type for the root volume.
In order to define the number of Iops set `rootVolumeIops: <number>` (minimum is 100)

If `rootVolumeType: io1` is set and `rootVolumeIops` is not defined, then `rootVolumeIops` defaults to 100.

I am not quite familiar with the Kops codebase and this is my first encounter with Go, so some changes might not be suitable (I also do not have a software developer background so bear with me :) ). Please review and add feed-back.  

I've included a small change to the Makefile as I compiled Kops on a Mac and didn't had $GOPATH set after installing Go. I thought that pulling this via `go env` would be more flexible, but I am not 100% sure as I don't do much development in this area and not sure about possible use cases.
2017-08-01 09:03:50 -07:00
Devipriya Sarkar 58820b8e44 Update update_kops.md
fix heading in the docs
2017-08-01 21:06:26 +05:30
Murali Reddy b7e1b12022 remove source/destination check requirement for kube-router
Kube-router automatically disables source/destination checks for the AWS
EC2 instances now user need not perform explicitly.

Fixed as part of https://github.com/cloudnativelabs/kube-router/issues/35
2017-08-01 19:27:58 +05:30
Markus Padourek 9665bd486c Update usage to 1.6.3 2017-08-01 08:47:33 +02:00
Markus Padourek cce013b1bb Fixed typo 2017-08-01 08:41:42 +02:00
Ionut Craciunescu 4d27d5d93c small docs fixes 2017-08-01 00:28:38 +01:00
Ionut Craciunescu 847bf0c2e1 updates to support aws disks with provisioned iops 2017-08-01 00:28:21 +01:00
Paul Capestany 9bc36e3515 Fix small typo 2017-07-31 15:57:47 -04:00
M S Vishwanath Bhat 2134d10255 docs/topology - Fix the rolling-update command
This patch updates the `kops rolling-update` command which should be
run after making changes to the API server topology.

Signed-off-by: M S Vishwanath Bhat <msvbhat@gmail.com>
2017-07-31 14:01:44 +05:30
Blake 4d9c69c167 Add documentation and update text fixture 2017-07-29 13:29:28 -07:00
AlexB138 e84791a5d2 Striking unnecessary and incorrect conversion-gen instruction 2017-07-28 18:46:47 -04:00
Markus Padourek fa7a4c49e4 Update addons docs 2017-07-28 13:07:00 +02:00
Kubernetes Submit Queue 9668b0fe8a Merge pull request #3059 from justinsb/update_17_relnotes
Automatic merge from submit-queue

Adding remainder of 1.7 relnotes
2017-07-27 00:08:53 -07:00
Justin Santa Barbara 22c39232a1 Adding remainder of 1.7 relnotes 2017-07-26 23:57:10 -04:00
Jean-Pierre Huynh 8e535c44ed Fix typo in the apireference README
Signed-off-by: Jean-Pierre Huynh <jean-pierre.huynh@ounet.fr>
2017-07-26 16:33:33 +01:00
craigmonson b58109bf33 fix "dederation" 2017-07-25 15:33:04 -04:00
craigmonson 60a2a0c85f fix "dederation" 2017-07-25 15:31:00 -04:00
Alexander Brandstedt 3dc91aff1c remove old docs file 2017-07-25 10:36:29 +02:00
Alexander Brandstedt 89150391c1 remove inline example file with eof 2017-07-25 10:23:59 +02:00
Alexander Brandstedt b0cf65ceca correct squash 2017-07-25 10:23:59 +02:00