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

Docker tutorial built into the cli #102

Closed
ivorscott opened this issue May 28, 2020 · 6 comments
Closed

Docker tutorial built into the cli #102

ivorscott opened this issue May 28, 2020 · 6 comments
Labels
community_new New idea raised by a community contributor

Comments

@ivorscott
Copy link

ivorscott commented May 28, 2020

Tell us about your request
Would be cool to have a docker tutorial built into the cli like Vim does.

Which service(s) is this request for?

  • docker cli
  • docker-compose
  • swarm

Tell us about the problem you're trying to solve. What are you trying to do, and why is it hard?
Beginners need tutorials for docker. To get one from docker currently they need to go to the official documentation. What if these tutorials or something similar were added directly to the cli. This would be easier for beginners to get started since they wouldn't have to leave the cli. Also you could even redirect the user to specific pages of documentation when a new topic is addressed (possibly making the docs easier to navigate)

Are you currently working around the issue?
No.

Additional context
Vim does this with vimtutor

Given vim is installed. Typing: vimtutor starts up an interactive tutorial in the terminal.
Docker could create a command called dockertutor that does something similar.

Screen Shot 2020-05-28 at 23 18 59

@ivorscott ivorscott added the community_new New idea raised by a community contributor label May 28, 2020
@BobbyCGD
Copy link

Loved the idea you suggested at DockerCon2020 🐳 🐋

@vpanga
Copy link

vpanga commented May 28, 2020

Good idea! Contextual help will be much helpful.

@manishtomar
Copy link

manishtomar commented Jun 9, 2020

@ivorscott Why was this closed?

@ivorscott ivorscott reopened this Jun 9, 2020
@ivorscott
Copy link
Author

ivorscott commented Jun 9, 2020

@manishtomar my bad. I was trying to comment.

@vpanga It could be an interactive command prompt experience. A user could enter the real docker commands as input to the program and when the input is correct the program executes the answer in the background. A small win would be making one of the official docker tutorials interactive: https://docs.docker.com/get-started/

For Example

$ dockertutor

Welcome to the Docker Tutor - Version 1

Docker is an open platform for developing, shipping, and running applications. This tutor aims to be an interactive tutorial for learning Docker. Docker enables you to separate your applications from your infrastructure so you can deliver software quickly.

The approximate time required to complete the tutor is 25-30 minutes, depending upon how much time is spent with experimentation.

Lesson 1.1: Testing Your Docker Version

Run docker --version to check the version of Docker installed on your machine.
$ docker --version
Docker version 19.03.5, build 633a0ea

Lesson 1.2: Test Docker Installation

Test that your installation works by running the hello-world Docker image. Run docker run hello-world.
$ docker run hello-world

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
ca4f61b1923c: Pull complete
Digest: sha256:ca0eeb6fb05351dfc8759c20733c91def84cb8007aa89a5bf606bc8b315b9fc7
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

Explanation

Docker runs processes in isolated containers. A container is a process which runs on a host. The host may be local or remote. When an operator executes docker run, the container process that runs is isolated in that it has its own file system, its own networking, and its own isolated process tree separate from the host.
https://docs.docker.com/engine/reference/run/

Lesson 2: ...

@3mard
Copy link

3mard commented Jun 10, 2020

Great Idea!
I'd love for this to happen !

ivorscott added a commit to ivorscott/dockertutor that referenced this issue Jun 28, 2020
@ivorscott
Copy link
Author

I've been experimenting with the idea. https://github.com/ivorscott/dockertutor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
community_new New idea raised by a community contributor
Projects
None yet
Development

No branches or pull requests

5 participants