Restructure the Ubuntu Getting Started section. #1932

castrojo · 2016-12-12T19:11:34Z

As per discussions on sig-cluster-lifecycle, we'd like our docs to be more lifecycle focused instead of one huge installation page. This breaks down the one big page into multiple smaller pages, it is mostly all new content.

This change is

pwittrock · 2016-12-12T20:27:53Z

@kubernetes/sig-cluster-lifecycle

@roberthbailey Is this something cluster lifecycle should look at?

mikedanese · 2016-12-12T21:02:51Z

docs/getting-started-guides/ubuntu/backups.md

+    path: /home/ubuntu/etcd-snapshots/etcd-snapshot-2016-11-09-02.41.47.tar.gz
+    sha256: 1dea04627812397c51ee87e313433f3102f617a9cab1d1b79698323f6459953d
+    size: 68K
+status: completed


close this code block

mikedanese · 2016-12-12T21:03:14Z

docs/getting-started-guides/ubuntu/backups.md

+The cluster must be in a state of only having a single member. So it's best to
+deploy a new cluster using the etcd charm, without adding any additional units.
+
+    juju deploy etcd new-etcd


should this be in a code block?

mikedanese · 2016-12-12T21:03:28Z

docs/getting-started-guides/ubuntu/backups.md

+
+> The above code snippet will deploy a single unit of etcd, as 'new-etcd'
+
+    juju run-action etcd/0 restore target=/mnt/etcd-backups


should this be in a code block?

mikedanese · 2016-12-12T21:04:02Z

docs/getting-started-guides/ubuntu/glossary.md

@@ -0,0 +1,11 @@
+# GLossary and Terminology 


k8s-ci-robot · 2016-12-15T13:42:48Z

Thanks for your pull request. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

📝 Please follow instructions at https://github.com/kubernetes/kubernetes/wiki/CLA-FAQ to sign the CLA.

Once you've signed, please reply here (e.g. "I signed it!") and we'll verify. Thanks.

If you've already signed a CLA, it's possible we don't have your GitHub username or you're using a different email address. Check your existing CLA data and verify that your email is set on your git commits.
If you signed the CLA as a corporation, please sign in with your organization's credentials at https://identity.linuxfoundation.org/projects/cncf to be authorized.

If you have questions or suggestions related to this bot's behavior, please file an issue against the kubernetes/test-infra repository.

castrojo · 2016-12-15T14:06:15Z

Sorry, bad rebase, sorry for the spam folks, fixed.

roberthbailey · 2016-12-16T18:41:30Z

@castrojo - needs rebase

roberthbailey · 2016-12-16T18:42:00Z

Also assigning @jaredbhatti for tech writer review.

mikedanese · 2017-01-06T18:39:30Z

Tech LGTM

castrojo · 2017-01-09T21:13:21Z

Fixes #2041

castrojo · 2017-01-09T21:13:48Z

Fixes #1952

castrojo · 2017-01-09T21:17:18Z

jaredbhatti · 2017-01-09T21:44:50Z

Pinged to put content into our new templates:
http://kubernetes.io/docs/contribute/page-templates/

Thanks!

devin-donnelly · 2016-12-27T22:28:57Z

docs/getting-started-guides/ubuntu/backups.md

+Copy the snapshot to the local disk and then check the sha256sum. 
+
+```
+    juju scp etcd/0:/home/ubuntu/etcd-snapshots/etcd-snapshot-2016-11-09-02.41.47.tar.gz .


If you're using a code block (```), the indentation isn't necessary. On the deploy preview, it's indented farther than the other code blocks.

devin-donnelly · 2017-01-10T19:28:59Z

@castrojo Docs LGTM modulo one wording issue in the main landing page. I think we can merge this once that's fixed.

However, we'll do so with the caveat that these kinds of guides to Bare Metal installation/running guides might/should move to a dedicated portion of the site.

devin-donnelly · 2017-01-10T19:30:01Z

docs/getting-started-guides/ubuntu/index.md

+---
+
+{% capture overview %}
+There are multiple ways to run a Kubernetes with Ubuntu. These pages explain how to deploy Kubernetes on Ubuntu on multiple public and private clouds, as well as bare metal. 


"run a Kubernetes" -> "run Kubernetes" or "run a Kubernetes cluster"

Will be happy to move to a dedicated bare metal section once that's in place.

I'm putting together a proposal that I hope to get out to sig-docs within a week.

- This supercedes PR #1770 - This breaks up the section from one huge installation page into: - A new index page. - New support grid with commercial and community support options. - Move to lifecycle-based pages based on operational tasks. - Add support for local deployments via LXD. - Added screenshots to images/docs/ubuntu - Add backup page. - Add decommissioning page. - Add a glossary of terms page. - Rewritten installation page. - Add logging page. - Add monitoring page. - Add networking page, flannel only for now, calico in progress. - Add a scaling page. - Add a security page. - Add a storage page. - Add a troubleshooting page. - Add an upgrade page. - Add a cluster validation page. - Add new ubuntu content to the index page. - Add Ubuntu to _data TOC. - Add warning about choosing ipv6 with LXD, thanks Ed Baluf. - Template-ize all the pages per jaredb's review.

devin-donnelly · 2017-01-11T00:04:32Z

Thanks! Merging now.

k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Dec 12, 2016

k8s-github-robot assigned pwittrock Dec 12, 2016

pwittrock removed their assignment Dec 12, 2016

k8s-github-robot assigned errordeveloper Dec 12, 2016

pwittrock assigned roberthbailey Dec 12, 2016

mikedanese reviewed Dec 12, 2016

View reviewed changes

docs/getting-started-guides/ubuntu/glossary.md Outdated

@@ -0,0 +1,11 @@

# GLossary and Terminology

Copy link

Member

mikedanese Dec 12, 2016

Choose a reason for hiding this comment

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

GLossary

This was referenced Dec 15, 2016

Ubuntu installation document not available #1952

Closed

Add an index page for the ubuntu root directory. #1770

Closed

roberthbailey assigned mikedanese Dec 16, 2016

roberthbailey assigned jaredbhatti Dec 16, 2016

roberthbailey removed their assignment Dec 20, 2016

devin-donnelly assigned devin-donnelly and unassigned jaredbhatti Dec 21, 2016

adam-stokes approved these changes Dec 21, 2016

View reviewed changes

mikedanese added the Tech Review LGTM label Jan 9, 2017

devin-donnelly reviewed Jan 10, 2017

View reviewed changes

devin-donnelly suggested changes Jan 10, 2017

View reviewed changes

jaredbhatti mentioned this pull request Jan 10, 2017

Update Ubuntu install guide for v1.2.x #440

Closed

devin-donnelly approved these changes Jan 11, 2017

View reviewed changes

devin-donnelly merged commit c113468 into kubernetes:master Jan 11, 2017

jaredbhatti mentioned this pull request Jan 11, 2017

I wish /docs/getting-started-guides/ listed both Ubuntu guides in the Bare Metal section, noting the networking for each #572

Closed

chenopis mentioned this pull request Jan 12, 2017

Issue with /docs/getting-started-guides/ubuntu/ #1517

Closed

2 tasks

This was referenced Jan 29, 2017

Install in Ubuntu - Broken link kubernetes/kubernetes#38506

Closed

Fix broken links in Ubuntu Getting Started Guide kubernetes/kubernetes#38546

Closed


		> The above code snippet will deploy a single unit of etcd, as 'new-etcd'

		juju run-action etcd/0 restore target=/mnt/etcd-backups

Restructure the Ubuntu Getting Started section. #1932

Restructure the Ubuntu Getting Started section. #1932

Uh oh!

Conversation

castrojo commented Dec 12, 2016 • edited by k8s-reviewable Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pwittrock commented Dec 12, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

k8s-ci-robot commented Dec 15, 2016

Uh oh!

castrojo commented Dec 15, 2016

Uh oh!

roberthbailey commented Dec 16, 2016

Uh oh!

roberthbailey commented Dec 16, 2016

Uh oh!

mikedanese commented Jan 6, 2017

Uh oh!

castrojo commented Jan 9, 2017

Uh oh!

castrojo commented Jan 9, 2017

Uh oh!

castrojo commented Jan 9, 2017

Uh oh!

jaredbhatti commented Jan 9, 2017

Uh oh!

Choose a reason for hiding this comment

Uh oh!

devin-donnelly commented Jan 10, 2017 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

devin-donnelly commented Jan 11, 2017

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

castrojo commented Dec 12, 2016 •

edited by k8s-reviewable

Loading

pwittrock commented Dec 12, 2016 •

edited

Loading

devin-donnelly commented Jan 10, 2017 •

edited

Loading