Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Kubernetes 101 tutorial does not mention incompatibility with ARM architecture #18726

Open
lodewijkvankeizerswaard opened this issue Apr 23, 2024 · 6 comments
Assignees
Labels
kind/documentation Categorizes issue or PR as related to documentation.

Comments

@lodewijkvankeizerswaard

What Happened?

I tried to follow the Kubernetes 101 tutorial on my Apple Silicon device. The image used in this tutorial, however, is not compatible with ARM architectures.

The tutorial should make a quick mention of this incompatibility to avoid confusion among new users.

Attach the log file

(irrelevant)

Operating System

macOS (Default)

Driver

Docker

@lodewijkvankeizerswaard
Copy link
Author

lodewijkvankeizerswaard commented Apr 23, 2024

I updated the documentation on a fork, under the impression that I would be able to create a pull request. However, I cannot.

@afbjorklund
Copy link
Collaborator

afbjorklund commented Apr 23, 2024

It was updated in the other deployment, unfortunately there is some duplication:

https://kubernetes.io/docs/tutorials/kubernetes-basics/deploy-app/deploy-intro/

There are some other deployments of the same content (including the old Katacoda)

https://kubernetesbootcamp.github.io/kubernetes-bootcamp/


The main issue is that the original tutorial image has not been updated in years...

REPOSITORY                                  TAG       IMAGE ID       CREATED       SIZE
gcr.io/google-samples/kubernetes-bootcamp   v1        8fafd8af70e9   7 years ago   211MB

https://github.com/jocatalin/bootcamp/blob/gh-pages/code/docker/

FROM node:slim
EXPOSE 8080
COPY server.js .
CMD node server.js

@afbjorklund afbjorklund added the kind/documentation Categorizes issue or PR as related to documentation. label Apr 23, 2024
@lodewijkvankeizerswaard
Copy link
Author

Yes, I found the other deployment. It was what eventually got me on the right track. Thanks for the clarification.

Although maintaining forks of the same content in parallel is suboptimal, it might still be a good idea to add this note. Do you accept pull requests, or should I consider "this" all I can do for the moment?

@afbjorklund
Copy link
Collaborator

afbjorklund commented Apr 23, 2024

A warning in the documentation is OK, but better would be to rebuild the image - like we did for the "echoserver".

I'm not sure why they are still using node 6.3.1 instead of upgrading to a later version (currently node 20.12.2 LTS)

@afbjorklund
Copy link
Collaborator

@spowelljr : Can the new "bootcamp" image be hosted under kicbase, similar to the new echo-server ?

@spowelljr
Copy link
Member

Sure, when I get a second I'll build and push the a multi arch image and update the tutorial

@spowelljr spowelljr self-assigned this Apr 30, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind/documentation Categorizes issue or PR as related to documentation.
Projects
None yet
Development

No branches or pull requests

3 participants