From f0a3a4329ecaaadd60331641712d5e9b35e1120f Mon Sep 17 00:00:00 2001 From: TomSweeneyRedHat Date: Thu, 13 Sep 2018 11:49:19 -0400 Subject: Add notes to check version on problem Signed-off-by: TomSweeneyRedHat Closes: #1462 Approved by: rhatdan --- .github/ISSUE_TEMPLATE.md | 19 +++++++++++++------ README.md | 1 + troubleshooting.md | 15 +++++++++++++-- version/version.go | 3 +++ 4 files changed, 30 insertions(+), 8 deletions(-) diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md index f4a25be88..4b6ddb2e4 100644 --- a/.github/ISSUE_TEMPLATE.md +++ b/.github/ISSUE_TEMPLATE.md @@ -4,20 +4,27 @@ BUG REPORT INFORMATION --------------------------------------------------- Use the commands below to provide key information from your environment: You do NOT have to include this information if this is a FEATURE REQUEST +--> + +**NOTE** A large number of issues reported against Podman are often found to already be fixed +in more current versions of the project. Before reporting an issue, please verify the +version you are running with `podman version` and compare it to the latest release +documented on the top of Podman's [README.md](../README.md). If they differ, please +update your version of Podman to the latest possible and retry your command before creating +an issue. If you are filing a bug against `podman build`, please instead file a bug against Buildah (https://github.com/projectatomic/buildah/issues). Podman build executes Buildah to perform container builds, and as such the Buildah maintainers are best equipped to handle these bugs. ---> **Is this a BUG REPORT or FEATURE REQUEST?**: -> Uncomment only one, leave it on its own line: -> -> /kind bug -> -> /kind feature +[//]: # Uncomment only one, leave it on its own line: + +[//]: # **kind bug** + +[//]: # **kind feature** **Description** diff --git a/README.md b/README.md index 0f31c24a9..63996caa4 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ ![PODMAN logo](logo/podman-logo-source.svg) # libpod - library for running OCI-based containers in Pods +### Latest Version: 0.9.1 ### Status: Active Development ## What is the scope of this project? diff --git a/troubleshooting.md b/troubleshooting.md index d0d84f7cc..db36d1bb8 100644 --- a/troubleshooting.md +++ b/troubleshooting.md @@ -5,7 +5,18 @@ ## A list of common issues and solutions for Podman --- -### 1) No such image or Bare keys cannot contain ':' +### 1) Variety of issues - Validate Version + +A large number of issues reported against Podman are often found to already be fixed +in more current versions of the project. Before reporting an issue, please verify the +version you are running with `podman version` and compare it to the lastest release +documented on the top of Podman's [README.md](README.md). + +If they differ, please update your version of PODMAN to the latest possible +and retry your command before reporting the issue. + +--- +### 2) No such image or Bare keys cannot contain ':' When doing a `podman pull` or `podman build` command and a "common" image can not be pulled, it is likely that the `/etc/containers/registries.conf` file is either not installed or possibly @@ -33,7 +44,7 @@ error pulling image "fedora": unable to pull fedora: error getting default regis * i.e. `registries = ['registry.fedoraproject.org', 'quay.io', 'registry.access.redhat.com']` --- -### 2) http: server gave HTTP response to HTTPS client +### 3) http: server gave HTTP response to HTTPS client When doing a Podman command such as `build`, `commit`, `pull`, or `push` to a registry, tls verification is turned on by default. If authentication is not used with diff --git a/version/version.go b/version/version.go index d7c3b683e..7943adee4 100644 --- a/version/version.go +++ b/version/version.go @@ -1,4 +1,7 @@ package version // Version is the version of the build. +// NOTE: remember to bump the version at the top +// of the top-level README.md file when this is +// bumped. const Version = "0.9.2-dev" -- cgit v1.2.3-54-g00ecf