This repository has been archived by the owner on Oct 9, 2018. It is now read-only.
Refs #13453: document docker upload changes related to v2
#223
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| @@ -34,23 +34,15 @@ Then click save and then sync the Repository as you normally would. Katello will | |||
|
|
|||
| ## How to Upload Docker Images | |||
|
|
|||
| As an alternative to syncing content, Docker images can be uploaded directly into Katello either by the UI or the CLI. These images can either be added to Repositories which have been synced from an external source such as Docker Hub, or they can be uploaded into Repositories which have no external source. For the latter, you can create a Repository in Katello with no upstream name or registry URL. This is handy if you just want to create a repository from only Docker images you plan to upload. | |||
| In versions of Katello prior to 2.5, Docker images could be uploaded directly via either the UI or CLI. However, Katello 2.5 only supports the Docker Registry v2 format, which is significantly different than the Docker Registry v1 format. The `docker save` command outputs a Docker image in v1 format, which cannot be uploaded directly to a v2 repository. | |||
There was a problem hiding this comment.
should this reference 3.0 rather than 2.5?
beav
force-pushed
the
docker-v2-upload
branch
from
5595218
to
e3e6bb5
Compare
|
updated to remove 2.5 reference |
| ``` | ||
| $ hammer repository upload-content --path centos_latest.tar --id 6 | ||
| ``` | ||
| Note the ":2" in the above command, which specifies a v2 registry. At this point, you can then push changes to your local Docker registry. Once this is complete, you can follow the instructions in the above section to add this registry and sync from it. This will ensure that your Docker content stays in Docker Registry v2 format. |
There was a problem hiding this comment.
maybe use backticks (```) here rather than quotes for the :2?
There was a problem hiding this comment.
the wording for this paragraph feels weird. Lots of "you can do thing" rather than just "do thing."
my suggestion:
Note the :2 above, which specifies a v2 registry. Push your changes to your newly created local registry then follow the instructions in the section above to sync this registry to Katello. This will ensure that your Docker content stays in Docker's v2 registry format.
beav
force-pushed
the
docker-v2-upload
branch
from
e3e6bb5
to
8b33468
Compare
|
@komidore64 updated for wording alteration |
|
looks good breh ack |
bbuckingham
added a commit
that referenced
this pull request
Feb 8, 2016
Refs #13453: document `docker upload` changes related to v2
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.