diff --git a/docs/content/blog/docker-mixin-blog-post.md b/docs/content/blog/docker-mixin-blog-post.md index f5eb21227..5d9fb82f6 100644 --- a/docs/content/blog/docker-mixin-blog-post.md +++ b/docs/content/blog/docker-mixin-blog-post.md @@ -15,7 +15,7 @@ Mixins are critical building blocks for bundles, and we hope the Docker mixin wi The Docker mixin abstracts this logic for you and allows you to specify the Docker commands with the arguments and flags that you want to execute directly in the Porter manifest. The commands currently provided by the Docker mixin are pull, push, run, build, login, and remove. To view all the syntax for the commands, take a look at the [README](https://github.com/deislabs/porter-docker). -Let's go through an example bundle to try out the mixin. First, we will use the Docker mixin to pull and run [docker/whalesay](https://hub.docker.com/r/docker/whalesay/). Then, we will write our own Dockerfile, build it, and push it to Docker Hub. +Let's go through an example bundle to try out the mixin. First, we will use the Docker mixin to pull and run [ghcr.io/getporter/examples/images/whalesay](https://github.com/orgs/getporter/packages/container/package/examples%2Fimages%2Fwhalesay). Then, we will write our own Dockerfile, build it, and push it to Docker Hub. ## Author the bundle Writing a bundle with the Docker mixin has a few steps: @@ -56,19 +56,19 @@ mixins: ### Use Docker CLI -Next, delete the install, upgrade, and uninstall actions. Now, to run docker/whalesay, copy and paste the code below into the porter.yaml to pull the image and then run it with a command to say "Hello World". +Next, delete the install, upgrade, and uninstall actions. Now, to run ghcr.io/getporter/examples/images/whalesay, copy and paste the code below into the porter.yaml to pull the image and then run it with a command to say "Hello World". ``` install: - docker: description: "Install Whalesay" pull: - name: docker/whalesay + name: ghcr.io/getporter/examples/images/whalesay tag: latest - docker: description: "Run Whalesay" run: name: dockermixin - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" command: cowsay arguments: - "Hello World" diff --git a/docs/content/blog/using-docker-in-bundles.md b/docs/content/blog/using-docker-in-bundles.md index fa9bda7ab..8f215d209 100644 --- a/docs/content/blog/using-docker-in-bundles.md +++ b/docs/content/blog/using-docker-in-bundles.md @@ -19,7 +19,7 @@ application, or even more creative tasks that you have already containerized. Well now you can reuse all that hard work and logic from within your bundles! -Let's walk through using my favorite container, [docker/whalesay][whalesay], in a bundle. +Let's walk through using my favorite container, [ghcr.io/getporter/examples/images/whalesay][whalesay], in a bundle. ``` _____________________ @@ -38,7 +38,7 @@ Let's walk through using my favorite container, [docker/whalesay][whalesay], in \____\______/ ``` -[whalesay]: https://hub.docker.com/r/docker/whalesay/ +[whalesay]: https://github.com/orgs/getporter/packages/container/package/examples%2Fimages%2Fwhalesay ## Author the bundle Writing a bundle that uses Docker has a few steps: @@ -128,7 +128,7 @@ mixins: install: - docker: run: - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" rm: true arguments: - cowsay @@ -137,7 +137,7 @@ install: upgrade: - docker: run: - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" rm: true arguments: - cowsay @@ -146,7 +146,7 @@ upgrade: say: - docker: run: - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" rm: true arguments: - cowsay @@ -155,7 +155,7 @@ say: uninstall: - docker: run: - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" rm: true arguments: - cowsay diff --git a/docs/content/docs/getting-started/create-bundle.md b/docs/content/docs/getting-started/create-bundle.md index d4657bf28..707f4acc2 100644 --- a/docs/content/docs/getting-started/create-bundle.md +++ b/docs/content/docs/getting-started/create-bundle.md @@ -186,13 +186,13 @@ install: - docker: description: "Install Whalesay" pull: - name: docker/whalesay + name: ghcr.io/getporter/examples/images/whalesay tag: latest - docker: description: "Run Whalesay" run: name: dockermixin - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" command: cowsay arguments: - "Hello World" diff --git a/docs/content/docs/references/examples/airgap.md b/docs/content/docs/references/examples/airgap.md index d944649ac..d251c3480 100644 --- a/docs/content/docs/references/examples/airgap.md +++ b/docs/content/docs/references/examples/airgap.md @@ -49,16 +49,16 @@ images: whalesayd: description: "Whalesay as a service" imageType: "docker" - repository: "carolynvs/whalesayd" - digest: "sha256:8b92b7269f59e3ed824e811a1ff1ee64f0d44c0218efefada57a4bebc2d7ef6f" + repository: "ghcr.io/getporter/examples/images/whalesayd" + digest: "sha256:18c099989986f61c0678b8040cc8d2e80ba20ecd096da51f8da3a31c5d1138b8" ``` The repository field should be the image name, without a tag or digest included, and the digest is the repository digest of the image. You can get that information by running the following docker command: ```console -$ docker image inspect carolynvs/whalesayd:v0.1.0 --format '{{.RepoDigests}}' -[carolynvs/whalesayd@sha256:8b92b7269f59e3ed824e811a1ff1ee64f0d44c0218efefada57a4bebc2d7ef6f] +$ docker image inspect ghcr.io/getporter/examples/images/whalesayd:v0.1.1 --format '{{.RepoDigests}}' +[ghcr.io/getporter/examples/images/whalesayd@sha256:18c099989986f61c0678b8040cc8d2e80ba20ecd096da51f8da3a31c5d1138b8] ``` ### Specify new image location @@ -174,7 +174,7 @@ Containers: Image ID: docker.io/YOURNAME/whalegap@sha256:8b92b7269f59e3ed824e811a1ff1ee64f0d44c0218efefada57a4bebc2d7ef6f ``` -From the output of kubectl describe, you can see that the image deployed was not the original image referenced in the bundle, carolynvs/whalesayd, and instead it references a new location _inside_ the relocated bundle repository. +From the output of kubectl describe, you can see that the image deployed was not the original image referenced in the bundle, ghcr.io/getporter/examples/images/whalesayd, and instead it references a new location _inside_ the relocated bundle repository. All referenced images are published into the same repository as the bundle, and they are only available using their digest, not the original image name. ## Next Steps @@ -182,4 +182,4 @@ All referenced images are published into the same repository as the bundle, and * [Understand how Porter publishes archived bundles to a registry](/archive-bundles/) [ghcr.io/getporter/examples/whalegap]: https://github.com/orgs/getporter/packages/container/package/examples%2Fwhalegap -[whalesay app]: https://github.com/carolynvs/whalesayd +[whalesay app]: https://github.com/orgs/getporter/packages/container/package/examples%2Fimages%2Fwhalesayd diff --git a/docs/content/docs/references/examples/docker.md b/docs/content/docs/references/examples/docker.md index d17d303cb..8d31c5f60 100644 --- a/docs/content/docs/references/examples/docker.md +++ b/docs/content/docs/references/examples/docker.md @@ -19,7 +19,7 @@ application, or even more creative tasks that you have already containerized. Well now you can reuse all that hard work and logic from within your bundles! -Let's walk through using my favorite container, [docker/whalesay][whalesay], in a bundle. +Let's walk through using my favorite container, [ghcr.io/getporter/examples/images/whalesay][whalesay], in a bundle. ``` _____________________ @@ -38,7 +38,7 @@ Let's walk through using my favorite container, [docker/whalesay][whalesay], in \____\______/ ``` -[whalesay]: https://hub.docker.com/r/docker/whalesay/ +[whalesay]: https://github.com/orgs/getporter/packages/container/package/examples%2Fimages%2Fwhalesay ## Author the bundle Writing a bundle that uses Docker has a few steps: @@ -123,7 +123,7 @@ mixins: install: - docker: run: - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" rm: true arguments: - cowsay @@ -132,7 +132,7 @@ install: upgrade: - docker: run: - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" rm: true arguments: - cowsay @@ -141,7 +141,7 @@ upgrade: say: - docker: run: - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" rm: true arguments: - cowsay @@ -150,7 +150,7 @@ say: uninstall: - docker: run: - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" rm: true arguments: - cowsay diff --git a/docs/content/mixins/docker.md b/docs/content/mixins/docker.md index 38e2130b7..6beff8d59 100644 --- a/docs/content/mixins/docker.md +++ b/docs/content/mixins/docker.md @@ -87,7 +87,7 @@ You can specify either the tag or the digest. - docker: description: "Install Whalesay" pull: - name: docker/whalesay + name: ghcr.io/getporter/examples/images/whalesay tag: latest ```` @@ -183,7 +183,7 @@ You can specify either the tag or the digest. description: "Run Whalesay" run: name: mixinpractice - image: "docker/whalesay:latest" + image: "ghcr.io/getporter/examples/images/whalesay:latest" detach: true ports: - host: 8080