From c54b423cb3d12154255a81054d54f98536393f54 Mon Sep 17 00:00:00 2001 From: "W. Trevor King" Date: Thu, 17 May 2018 13:22:43 -0700 Subject: troubleshooting: Add console syntax highlighting These blocks include both shell input and command output. GitHub uses Linuguist for syntax highlighting [1]. Linguist defines a ShellSession language to highlight those [2], although I prefer the shorter 'console' alias. This commit also makes this file more consistent about including the leading prompt and sudo. I'd also be fine using the traditional '#' prompt for privileged users instead of '$ sudo', to be less opinionated about *how* the user acquires the privileges (via sudo or otherwise). Linguist's shell-session grammar is from Atom [3], and that grammar recognizes any of >$#% as the final prompt character [4]. But I've left this facet alone for now. [1]: https://help.github.com/articles/creating-and-highlighting-code-blocks/#syntax-highlighting [2]: https://github.com/github/linguist/blob/v6.1.0/lib/linguist/languages.yml#L4362-L4373 [3]: https://github.com/github/linguist/blame/v6.1.0/vendor/README.md#L335 [4]: https://github.com/atom/language-shellscript/blob/v0.26.3/grammars/shell-session.cson#L22 Signed-off-by: W. Trevor King Closes: #796 Approved by: rhatdan --- troubleshooting.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/troubleshooting.md b/troubleshooting.md index 25e750e40..d0d84f7cc 100644 --- a/troubleshooting.md +++ b/troubleshooting.md @@ -12,13 +12,16 @@ it is likely that the `/etc/containers/registries.conf` file is either not insta misconfigured. #### Symptom -``` -sudo podman build -f Dockerfile + +```console +$ sudo podman build -f Dockerfile STEP 1: FROM alpine error building: error creating build container: no such image "alpine" in registry: image not known ``` + or -``` + +```console $ sudo podman pull fedora error pulling image "fedora": unable to pull fedora: error getting default registries to try: Near line 9 (last key parsed ''): Bare keys cannot contain ':'. ``` @@ -37,8 +40,9 @@ tls verification is turned on by default. If authentication is not used with those commands, this error can occur. #### Symptom -``` -podman push alpine docker://localhost:5000/myalpine:latest + +```console +$ sudo podman push alpine docker://localhost:5000/myalpine:latest Getting image source signatures Get https://localhost:5000/v2/: http: server gave HTTP response to HTTPS client ``` -- cgit v1.2.3-54-g00ecf