Change:
<h3>Services and Labels</h3> </div> </div> <del> <div class="row"> <div class="col-md-8"> <p><img src="/docs/tutorials/kubernetes-basics/public/images/module_04_services.svg" width="150%" height="150%"></p> </div> </div> </del> <div class="row"> <div class="col-md-8"> <p>A Service routes traffic across a set of Pods. Services are the abstraction that allow pods to die and replicate in Kubernetes without impacting your application. Discovery and routing among dependent Pods (such as the frontend and backend components in an application) is handled by Kubernetes Services.</p>

Discussion:
This is a followup for . Diagram on The problem is that the diagram is misleading. It is not correctly depicting the relationship between a Deployment and a Node, i.e. a Deployment can span multiple Node. The diagram is also "overloaded", i.e. trying to deliver too much information in a single view. Maybe we should remove it, or better yet, revise it for clarity.
Many newcomers start from the tutorials and they tend to overwhelm by a lot of new concepts. Diagrams help the users to understand new concepts so I think it's preferable to replace better diagrams rather than remove them completely.
It has not been long since I learned Kubernetes and I agree with that diagrams play an important role in making the tools accessible. I'll happily work on a new diagram; it will be my first contribution to Kubernetes...
:+1: for revise
/triage accepted If revising, and even if the revised diagram looks different from other tutorials, I recommend using icons from See for an example of visual style (it renders pretty much anywhere but IMO looks best in Chrome / Chromium).
Made a replacement for the diagrams on . There is two very similar diagrams on the page and the only difference between the two is that the second one has labels. This might act as a replacement for both. Any suggestions and comments are greatly appreciated... !
I'd use the blue color everywhere for the icons, but feel free to use a different color for the labels. The Pod labelled should be blue not purple. I would make the label for B be purpl;e. aside The Kubernetes fonts are for main text and for the logotype I'm not sure what that diagram is showing. It looks like there's a Deployment with 3 Pods (the ReplicaSet is not shown) and a bare Pod, and all 4 match the selector for the Service. There is also a bare Pod for app B. I don't see any Endpoints object, that might be useful to illustrate. for the Service, the selector is but it's not clear that that's a selector. How about changing the labels for the Pods and for the Deployment to be / , that way the selector stands out? I would also label the selector with the text “selector” or add a key to the diagram. in the Deployment, it's relevant that its Pods are labelled as app A. The label on the deployment is not relevant.

That's quite a lot of feedback - feel free to ask for more detail on any point
Thank you for the feedback. I got rid of the purple pod and made the contrast between the labels and the selector more distinct. I the ReplicaSet to make the diagram more accurate, and moved the label from the deployment to the pods. The latest version is below: ! The only part I am uncertain about is adding the endpoints. The main purpose of the text is to explain how selectors and labels are used to assign pods to services. Wouldn't adding endpoints make the diagram more complex than necessary?
That looks good - would you be willing to send in a pull request ? The rest of this feedback describes future work. As well (maybe a second PR?) I think I'd like to see a diagram that shows the packet flow, so this would include a load balancer and the 4 selected Pods. Probably not nodes, unless we think that's needed. We could make a more complex version of that diagram that also shows Endpoints / EndpointSlice objects, and add the complex diagram to The ideal outcome for me is that someone looking at this tutorial sees a hyperlink to a related page, and the reader can go from the tutorial page to another page that expands on the explanation without being overwhelming.
I'd love to send in a PR, but I have not been able to get Hugo working to test the dimensions of the image before committing. It keeps producing errors when I try to build the website in a container. I have all the dependencies installed and have no idea why this is happening.
Awesome! Thank you for creating a new diagram. I think it's much better than the current one. Here's some feedback: How about using the Labeled icons instead of Unlabeled ones from ? I think adding hints is better especially for the Pod icons. It's difficult for readers who see the Kubernetes icon for the first time, to understand the meaning of icons without labels. I feel the label color (for example "Deployment") is a bit too light and the contrast is low. Maybe the current color is ? How about changing it to ? It's conformant with the accessibility standard. You can check the color contrast with . For the container build error, did you try to follow ?
Thank you for the feedback.

I applied your suggestions and fixed some consistency errors with coloring, positioning etc. The latest version is below: ! I will try to fix the container build error today. Yes, I followed the instructions on the (a couple of times) but no luck. Regardless, I'll send an update.
It looks good to me. Thank you That's unfortunate... But if you open a PR against the branch on this repository, the preview build will be triggered by Netlify. So we can check what looks like the change of the page and diagram.
This diagram looks good to me. One improvement I can think of is to change the service IP to a different subnet.