New getting started blog post by JasonHaley · Pull Request #14970 · kubernetes/website

JasonHaley · 2019-06-18T23:59:57Z

I'd like to submit a blog post for the kubernetes.io blog targeted to people just getting started with Kubernetes. I myself am still new to it but want to start writing more to share what I am learning and help others along the way. My point of view is a little different than most people who post on the kubernetes.io blog since I am an independent consultant and I also work mostly with Microsoft products - so some of my resources are from Microsoft which seems rare for some reason in most Kubernetes blog posts I find on the web.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Remember to delete this note before submitting your pull request.

For pull requests on 1.15 Features: set Milestone to 1.15 and Base Branch to dev-1.15

For pull requests on Chinese localization, set Base Branch to release-1.14

For pull requests on Korean Localization: set Base Branch to dev-1.14-ko.<latest team milestone>

If you need Help on editing and submitting pull requests, visit:
https://kubernetes.io/docs/contribute/start/#improve-existing-content.

If you need Help on choosing which branch to use, visit:
https://kubernetes.io/docs/contribute/start#choose-which-git-branch-to-use.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

I'd like to submit a blog post for the kubernetes.io blog targeted to people just getting started with Kubernetes. I myself am still new to it but want to start writing more to share what I am learning and help others along the way. My point of view is a little different than most people who post on the kubernetes.io blog since I am an independent consultant and I also work mostly with Microsoft products - so some of my resources are from Microsoft which seems rare for some reason in most Kubernetes blog posts I find on the web.

k8s-ci-robot · 2019-06-18T23:59:58Z

Welcome @JasonHaley!

It looks like this is your first PR to kubernetes/website 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/website has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

netlify · 2019-06-19T00:08:50Z

Deploy preview for kubernetes-io-master-staging ready!

Built with commit f675b07

https://deploy-preview-14970--kubernetes-io-master-staging.netlify.com

JasonHaley · 2019-06-19T00:10:32Z

I have 4 images to include but didn't get them included on the PR. I couldn't figure out how to add the images, I don't see a directory in the repo that has images from the other blogs. How can I' get the images added? /assign @kbarnard10

zhangqx2010 · 2019-06-19T01:03:32Z

@JasonHaley Thanks for your PR.You can add images to /static/images/blog.

I added the image files and changed the paths in the markdown to /static/images/blog/...

JasonHaley · 2019-06-19T11:25:25Z

I added the images and modified the markdown, but I believe the md and images may not be in the right location now (i think they are off the root of the repo). Sorry that - this is my first pull request on a public repo, so I'm learning my way here. Is there something I need to do to fix the location now? Should I just start over with a new pull request? /assign @zacharysarah

castrojo · 2019-06-19T15:00:00Z

I can't take a look at this until next week but would be happy to help get your images and links sorted.

JasonHaley · 2019-06-19T15:15:22Z

Ok, thank you. Again sorry for any trouble due to me not adding the images in the initial PR. From: Jorge O. Castro <notifications@github.com> Sent: Wednesday, June 19, 2019 11:04 AM To: kubernetes/website <website@noreply.github.com> Cc: Jason Haley <jason@jasonhaley.com>; Mention <mention@noreply.github.com> Subject: Re: [kubernetes/website] New getting started blog post (#14970) I can't take a look at this until next week but would be happy to help get your images and links sorted. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub<#14970?email_source=notifications&email_token=ABAXYFCDNDBZZG4RZIPLUTLP3JDH3A5CNFSM4HZEYDLKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGODYCEZLI#issuecomment-503598253>, or mute the thread<https://github.com/notifications/unsubscribe-auth/ABAXYFCQE252BGECEDYPH4LP3JDH3ANCNFSM4HZEYDLA>.

zhangqx2010 · 2019-06-19T23:53:07Z

@JasonHaley Dont't worry. This guide may help a little. And I think the file name may need some change.

JasonHaley · 2019-06-20T09:25:04Z

Yeah I read through that guide which is where I messed up. the "Create new file" button works great but I think I could have used some direction at that point for what to do with any images. Once I created the initial PR, I couldn't figure out the multiple files after the fact.

zhangqx2010 · 2019-06-20T12:03:24Z

Oh I see. It's better to add some guide for the image location.

zhangqx2010 · 2019-06-20T12:08:59Z

get-started-with-kubernetes-using-python.md

@@ -0,0 +1,217 @@
+---


I think this file location needs to be changed. 😄

And help needed from native English speaker to review the content.

zhangqx2010 · 2019-06-20T13:01:37Z

@JasonHaley I just created a PR to your repo to fix the path. Please check and do the merge.

Thanks!

JasonHaley · 2019-06-20T13:12:48Z

I merged @zhangqx2010 image path fixes. /assign @kbarnard10

zhangqx2010 · 2019-06-24T03:01:23Z

@JasonHaley
You need add date content for your blog so that your article will appear on the netlify preivew:
e.g.

---
layout: blog
title: Get started with Kubernetes (using Python)
date: 2019-06-20

sftim · 2019-06-24T07:49:34Z

content/en/blog/_posts/get-started-with-kubernetes-using-python.md

+
+There are only two files in this directory. If you look at the main.py file, you’ll see the application prints out a hello message. You can learn more about Flask on the [Flask website](http://flask.pocoo.org/).
+
+```


Hi. If you wanted to have this highlighted as Python you could do that (append python to this line). What do you think?

Not a bad idea. It would make sense that someone may want to also learn more about Python, though originally I didn't really want to highlight a specific language. My original title didn't have it in there either but I got some feedback that it might make sense to put it in the title.

Added a date to get it on netlify preview

JasonHaley

I added a date in the header. Not sure what the next step is. /assign @kbarnard10

jaypipes

Hi @JasonHaley, great beginner's writeup, thank you! I've left a few comments/suggestions inline, but nothing too major.

jaypipes · 2019-06-26T12:30:45Z

content/en/blog/_posts/get-started-with-kubernetes-using-python.md

+```
+pip install -r requirements.txt
+python main.py
+```


You may wish to put a note here mentioning that running pip install isn't recommended for most scenarios. Instead, it's more common practice to use virtualenv (or pyenv) and install dependencies within a virtual environment.

Ok, once again that shows how much of a beginner I am in Python. Thank you for your review notes, they really add to the quality of the blog!

jaypipes · 2019-06-26T12:39:43Z

content/en/blog/_posts/get-started-with-kubernetes-using-python.md

+3. Set the working directory to that new app directory.
+4. Copy the local directory’s contents to that new folder into the image.
+5. Run the pip installer (just like we did earlier) to pull the requirements into the image.
+6. Configure port 5000 to be open.


It's not really that EXPOSE "opens" a port or actually that EXPOSE performs any action at all. Rather, it serves more as documentation to the user of the image that the service daemon running in the image is listening on a particular port. This allows the user of the image to set up a port redirection on the host by calling docker run -P or docker run -p.

Oh wow, that totally shows how much of a beginner I am - I wasn't aware of that it really doesn't do anything in the Dockerfile.

jaypipes · 2019-06-26T12:43:01Z

content/en/blog/_posts/get-started-with-kubernetes-using-python.md

+### Create an image
+At your command line or shell, in the hello-python/app directory, build the image with the following command:
+```
+docker build -f Dockerfile -t hello-python:latest .


Might be worth mentioning in a note here that using the :latest tag on an image can be error-prone. See here for more information: https://container-solutions.com/docker-latest-confusion/

I added a note about that and pointed to the link, but I'm not sure if it belongs. See what you think.

jaypipes · 2019-06-26T12:45:41Z

content/en/blog/_posts/get-started-with-kubernetes-using-python.md

+
+Now let’s have it run the application. Create a file named deployment.yaml and add the following contents to it and then save it:
+
+```


use the following here to enable syntax highlighting:

```yaml

Very cool, I didn't know that.

jaypipes · 2019-06-26T12:48:18Z

content/en/blog/_posts/get-started-with-kubernetes-using-python.md

+
+Make sure it is using the Docker for Desktop context by running the following:
+```
+kubectl config use-context docker-for-desktop


I'm not sure this is needed or recommended for readers not using Windows (or Mac?). Perhaps worth prefacing the above with "If you are running on Windows or Mac, make sure.."

Ok, I'm definitely coming from a windows point of view, so thanks that helps broaden the message.

jaypipes · 2019-06-26T12:51:38Z

content/en/blog/_posts/get-started-with-kubernetes-using-python.md

+3. Create a deployment and run the application in Kubernetes
+
+## Prerequisites
+* [Docker Desktop with Kubernetes](https://www.docker.com/products/kubernetes) installed (see end of blog for enabling Kubernetes)


Might be better to just list "A Kubernetes service" here, possibly with a link to the various installation methods here: https://kubernetes.io/docs/setup/.

Ok, that makes sense I work that in. One of the ideas I had with this blog was get across the message that if you are already working with Docker, it is easy to also start learning Kubernetes (instead of Docker Swarm) with the tools you already have.

jaypipes · 2019-06-26T12:53:41Z

content/en/blog/_posts/get-started-with-kubernetes-using-python.md

+```
+<img src="/images/blog/get-started-with-kubernetes-using-python/kubectl-get-pods.png" alt="Pod listing" />
+
+Now navigate to http://localhost:6001, and you should see the “Hello form Python!” message. 


The load balancer is exposed on port 6000 in the configuration above, not 6001.

Thanks, nice catch!

mrbobbytables

Overall looks pretty solid, one small suggestion and I'd +1 @jaypipes comments.

mrbobbytables · 2019-06-26T16:19:32Z

content/en/blog/_posts/get-started-with-kubernetes-using-python.md

+  type: LoadBalancer
+
+---
+apiVersion: apps/v1beta1


Suggested change

apiVersion: apps/v1beta1

apiVersion: apps/v1

With the upcoming deprecation of apps/v1beta1 I would suggest using the stable v1 api

Cool, I wasn't aware of that.

JasonHaley · 2019-06-27T12:37:24Z

I worked in some good fixes from @mrbobbytables and @jaypipes.

/assign @kbarnard10 @castrojo @vonguard

JasonHaley · 2019-07-02T14:48:02Z

Any update on this?

tengqm · 2019-07-08T06:29:28Z

/lgtm

JasonHaley · 2019-07-16T21:08:48Z

@castrojo or @vonguard any chance you can take a look at this soon?

vonguard · 2019-07-16T21:12:43Z

I can take a gander tomorrow first thing. Poke me if I don't reply after noon.

…

On Tue, Jul 16, 2019, 2:08 PM Jason Haley ***@***.***> wrote: @castrojo <https://github.com/castrojo> or @vonguard <https://github.com/vonguard> any chance you can take a look at this soon? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#14970?email_source=notifications&email_token=AAAPJQCZZII4FQGPBETNYDTP7Y2GXA5CNFSM4HZEYDLKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD2CFC2Q#issuecomment-511988074>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAAPJQBOW5IUOOQ4DKWMKJ3P7Y2GXANCNFSM4HZEYDLA> .

vonguard · 2019-07-17T15:27:57Z

/lgtm

JasonHaley · 2019-07-19T00:12:40Z

@vonguard Thanks! Next questions is how does it get approved?

JasonHaley · 2019-07-23T10:44:22Z

/assign @kbarnard10

…-07-23-get-started-with-kubernetes-using-python.md

kbarnard10 · 2019-07-23T16:13:25Z

/approve

k8s-ci-robot · 2019-07-23T16:14:00Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: kbarnard10

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

~~content/en/blog/OWNERS~~ [kbarnard10]
~~static/images/blog/OWNERS~~ [kbarnard10]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

kbarnard10 · 2019-07-23T17:52:01Z

/lgtm

JasonHaley · 2019-07-24T23:21:13Z

@kbarnard10 it seems the formatting is off when getting translated into html. Looks like a blockquote isn't getting closed right before the heading "Run locally".

It shows fine in markdown here: https://github.com/kubernetes/website/blob/master/content/en/blog/_posts/2019-07-23-get-started-with-kubernetes-using-python.md

But the code formatting gets inverted on this one:
https://kubernetes.io/blog/2019/07/23/get-started-with-kubernetes-using-python/

Do you know what I need to do to fix it? or do you know what component is used to convert from markdown to html? I can try and figure it out if so.

k8s-ci-robot requested review from castrojo and vonguard June 19, 2019 00:00

Added the images and changed md for path

37a4057

I added the image files and changed the paths in the markdown to /static/images/blog/...

kbarnard10 requested a review from mrbobbytables June 20, 2019 02:58

kbarnard10 self-assigned this Jun 20, 2019

zhangqx2010 reviewed Jun 20, 2019

View reviewed changes

fix path

beb656a

Merge pull request #2 from zhangqx2010/patch-1

ca81cda

Thanks!

sftim reviewed Jun 24, 2019

View reviewed changes

Added date to header

7bc435e

Added a date to get it on netlify preview

JasonHaley commented Jun 24, 2019

View reviewed changes

jaypipes reviewed Jun 26, 2019

View reviewed changes

mrbobbytables reviewed Jun 26, 2019

View reviewed changes

made changes

0a8f257

k8s-ci-robot assigned tengqm Jul 8, 2019

k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jul 8, 2019

k8s-ci-robot assigned vonguard Jul 17, 2019

Update and rename get-started-with-kubernetes-using-python.md to 2019…

f675b07

…-07-23-get-started-with-kubernetes-using-python.md

k8s-ci-robot removed the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jul 23, 2019

k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jul 23, 2019

k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jul 23, 2019

k8s-ci-robot merged commit d18d07a into kubernetes:master Jul 23, 2019


		There are only two files in this directory. If you look at the main.py file, you’ll see the application prints out a hello message. You can learn more about Flask on the [Flask website](http://flask.pocoo.org/).

		```


		Now let’s have it run the application. Create a file named deployment.yaml and add the following contents to it and then save it:

		```

Conversation

JasonHaley commented Jun 18, 2019

Uh oh!

k8s-ci-robot commented Jun 18, 2019

Uh oh!

netlify bot commented Jun 19, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

JasonHaley commented Jun 19, 2019

Uh oh!

zhangqx2010 commented Jun 19, 2019

Uh oh!

JasonHaley commented Jun 19, 2019

Uh oh!

castrojo commented Jun 19, 2019

Uh oh!

JasonHaley commented Jun 19, 2019 via email

Uh oh!

zhangqx2010 commented Jun 19, 2019

Uh oh!

JasonHaley commented Jun 20, 2019

Uh oh!

zhangqx2010 commented Jun 20, 2019

Uh oh!

Choose a reason for hiding this comment

Uh oh!

zhangqx2010 commented Jun 20, 2019

Uh oh!

JasonHaley commented Jun 20, 2019

Uh oh!

zhangqx2010 commented Jun 24, 2019

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

JasonHaley left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jaypipes left a comment

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!

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!

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!

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!

mrbobbytables left a comment

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!

JasonHaley commented Jun 27, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

netlify bot commented Jun 19, 2019 •

edited

Loading

JasonHaley left a comment •

edited

Loading

JasonHaley commented Jun 27, 2019 •

edited

Loading