-
Notifications
You must be signed in to change notification settings - Fork 67
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1085 from chainguard-dev/create-pull-request/patch
[AutoDocs] Update Images Reference Docs
- Loading branch information
Showing
84 changed files
with
2,370 additions
and
195 deletions.
There are no files selected for viewing
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
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
42 changes: 42 additions & 0 deletions
42
content/chainguard/chainguard-images/reference/atlantis/_index.md
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
--- | ||
title: "Image Overview: atlantis" | ||
linktitle: "atlantis" | ||
type: "article" | ||
layout: "single" | ||
description: "Overview: atlantis Chainguard Image" | ||
date: 2022-11-01T11:07:52+02:00 | ||
lastmod: 2022-11-01T11:07:52+02:00 | ||
draft: false | ||
tags: ["Reference", "Chainguard Images", "Product"] | ||
images: [] | ||
menu: | ||
docs: | ||
parent: "images-reference" | ||
weight: 500 | ||
toc: true | ||
--- | ||
|
||
{{< tabs >}} | ||
{{< tab title="Overview" active=true url="/chainguard/chainguard-images/reference/atlantis/" >}} | ||
{{< tab title="Variants" active=false url="/chainguard/chainguard-images/reference/atlantis/image_specs/" >}} | ||
{{< tab title="Tags History" active=false url="/chainguard/chainguard-images/reference/atlantis/tags_history/" >}} | ||
{{< tab title="Provenance" active=false url="/chainguard/chainguard-images/reference/atlantis/provenance_info/" >}} | ||
{{</ tabs >}} | ||
|
||
|
||
|
||
Minimal image for Atlantis. | ||
|
||
## Get It! | ||
|
||
The image is available on `cgr.dev`: | ||
|
||
``` | ||
docker pull cgr.dev/chainguard/atlantis:latest | ||
``` | ||
|
||
## Usage | ||
|
||
This image is a drop-in replacement for the upstream image. Please refer to the [installation guide](https://www.runatlantis.io/docs/installation-guide.html) for more details. | ||
|
||
Atlantis has an [official Helm chart](https://github.com/runatlantis/helm-charts/tree/main), more instructions can be find in the [deployment guide](https://www.runatlantis.io/docs/deployment.html#kubernetes-helm-chart). |
84 changes: 84 additions & 0 deletions
84
content/chainguard/chainguard-images/reference/atlantis/image_specs.md
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,84 @@ | ||
--- | ||
title: "atlantis Image Variants" | ||
type: "article" | ||
unlisted: true | ||
description: "Detailed information about the public atlantis Chainguard Image variants" | ||
date: 2023-03-07T11:07:52+02:00 | ||
lastmod: 2023-03-07T11:07:52+02:00 | ||
draft: false | ||
tags: ["Reference", "Chainguard Images", "Product"] | ||
images: [] | ||
weight: 550 | ||
toc: true | ||
--- | ||
|
||
{{< tabs >}} | ||
{{< tab title="Overview" active=false url="/chainguard/chainguard-images/reference/atlantis/" >}} | ||
{{< tab title="Variants" active=true url="/chainguard/chainguard-images/reference/atlantis/image_specs/" >}} | ||
{{< tab title="Tags History" active=false url="/chainguard/chainguard-images/reference/atlantis/tags_history/" >}} | ||
{{< tab title="Provenance" active=false url="/chainguard/chainguard-images/reference/atlantis/provenance_info/" >}} | ||
{{</ tabs >}} | ||
|
||
This page shows detailed information about all public variants of the Chainguard **atlantis** Image. | ||
|
||
## Variants Compared | ||
The **atlantis** Chainguard Image currently has 2 public variants: | ||
|
||
- `latest-dev` | ||
- `latest` | ||
|
||
The table has detailed information about each of these variants. | ||
|
||
| | latest-dev | latest | | ||
|--------------|---------------------|---------------------| | ||
| Default User | `nonroot` | `nonroot` | | ||
| Entrypoint | `/usr/bin/atlantis` | `/usr/bin/atlantis` | | ||
| CMD | not specified | not specified | | ||
| Workdir | not specified | not specified | | ||
| Has apk? | yes | no | | ||
| Has a shell? | yes | yes | | ||
|
||
Check the [tags history page](/chainguard/chainguard-images/reference/atlantis/tags_history/) for the full list of available tags. | ||
|
||
## Packages Included | ||
The table shows package distribution across variants. | ||
|
||
| | latest-dev | latest | | ||
|---------------------------|------------|--------| | ||
| `apk-tools` | X | | | ||
| `atlantis` | X | X | | ||
| `bash` | X | | | ||
| `busybox` | X | X | | ||
| `ca-certificates-bundle` | X | X | | ||
| `conftest` | X | X | | ||
| `cue` | X | X | | ||
| `curl` | X | X | | ||
| `dumb-init` | X | X | | ||
| `git` | X | X | | ||
| `git-lfs` | X | X | | ||
| `glibc` | X | X | | ||
| `glibc-locale-posix` | X | X | | ||
| `gnupg` | X | X | | ||
| `ld-linux` | X | X | | ||
| `libbrotlicommon1` | X | X | | ||
| `libbrotlidec1` | X | X | | ||
| `libcap` | X | X | | ||
| `libcrypt1` | X | X | | ||
| `libcrypto3` | X | X | | ||
| `libcurl-openssl4` | X | X | | ||
| `libexpat1` | X | X | | ||
| `libnghttp2-14` | X | X | | ||
| `libpcre2-8-0` | X | X | | ||
| `libssl3` | X | X | | ||
| `ncurses` | X | | | ||
| `ncurses-terminfo-base` | X | | | ||
| `openssh-keygen` | X | X | | ||
| `openssh-server` | X | X | | ||
| `openssh-server-config` | X | X | | ||
| `openssl` | X | X | | ||
| `openssl-config` | X | X | | ||
| `openssl-provider-legacy` | X | X | | ||
| `terraform` | X | X | | ||
| `wolfi-baselayout` | X | X | | ||
| `zlib` | X | X | | ||
|
73 changes: 73 additions & 0 deletions
73
content/chainguard/chainguard-images/reference/atlantis/provenance_info.md
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,73 @@ | ||
--- | ||
title: "Provenance Information for atlantis Images" | ||
type: "article" | ||
unlisted: true | ||
description: "Provenance information for atlantis Chainguard Image" | ||
date: 2022-11-01T11:07:52+02:00 | ||
lastmod: 2022-11-01T11:07:52+02:00 | ||
draft: false | ||
tags: ["Reference", "Chainguard Images", "Product"] | ||
images: [] | ||
weight: 600 | ||
toc: true | ||
--- | ||
|
||
{{< tabs >}} | ||
{{< tab title="Overview" active=false url="/chainguard/chainguard-images/reference/atlantis/" >}} | ||
{{< tab title="Variants" active=false url="/chainguard/chainguard-images/reference/atlantis/image_specs/" >}} | ||
{{< tab title="Tags History" active=false url="/chainguard/chainguard-images/reference/atlantis/tags_history/" >}} | ||
{{< tab title="Provenance" active=true url="/chainguard/chainguard-images/reference/atlantis/provenance_info/" >}} | ||
{{</ tabs >}} | ||
|
||
All Chainguard Images contain verifiable signatures and high-quality SBOMs (software bill of materials), features that enable users to confirm the origin of each image built and have a detailed list of everything that is packed within. | ||
|
||
## Verifying Image Signatures | ||
The **atlantis** Chainguard Images are signed using Sigstore, and you can check the included signatures using `cosign`. | ||
|
||
The following command requires [cosign](https://docs.sigstore.dev/cosign/overview/) and [jq](https://stedolan.github.io/jq/) to be installed on your machine. It will pull detailed information about all signatures found for the provided image. | ||
|
||
```shell | ||
cosign verify --certificate-oidc-issuer=https://token.actions.githubusercontent.com --certificate-identity=https://github.com/chainguard-images/images/.github/workflows/release.yaml@refs/heads/main cgr.dev/chainguard/atlantis | jq | ||
``` | ||
|
||
By default, this command will fetch signatures for the `latest` tag. You can also specify the tag you want to fetch signatures for. | ||
|
||
## Downloading and Verifying SBOMs | ||
|
||
All Chainguard Images come with a high-quality Software Bill Of Materials (SBOM) attested at build-time. The SBOM can be downloaded using the cosign tool: | ||
|
||
```shell | ||
cosign download attestation \ | ||
--predicate-type=https://spdx.dev/Document \ | ||
cgr.dev/chainguard/atlantis | jq -r .payload | base64 -d | jq | ||
``` | ||
By default, this command will fetch the SBOM assigned to the `latest` tag. You can also specify the tag you want to fetch the SBOM from. | ||
|
||
With cosign 2.0+, you can use the `cosign verify-attestation` command to check the signature of an SBOM: | ||
|
||
```shell | ||
cosign verify-attestation \ | ||
--type https://spdx.dev/Document \ | ||
--certificate-oidc-issuer=https://token.actions.githubusercontent.com \ | ||
--certificate-identity=https://github.com/chainguard-images/images/.github/workflows/release.yaml@refs/heads/main \ | ||
--platform=linux/amd64 \ | ||
cgr.dev/chainguard/atlantis | ||
``` | ||
|
||
And you should get output that verifies the SBOM signature in cosign's transparency log: | ||
|
||
``` | ||
Verification for cgr.dev/chainguard/atlantis -- | ||
The following checks were performed on each of these signatures: | ||
- The cosign claims were validated | ||
- Existence of the claims in the transparency log was verified offline | ||
- The code-signing certificate was verified using trusted certificate authority certificates | ||
Certificate subject: https://github.com/chainguard-images/images/.github/workflows/release.yaml@refs/heads/main | ||
Certificate issuer URL: https://token.actions.githubusercontent.com | ||
GitHub Workflow Trigger: schedule | ||
GitHub Workflow SHA: da283c26829d46c2d2883de5ff98bee672428696 | ||
GitHub Workflow Name: .github/workflows/release.yaml | ||
GitHub Workflow Trigger chainguard-images/images | ||
GitHub Workflow Ref: refs/heads/main | ||
... | ||
``` |
30 changes: 30 additions & 0 deletions
30
content/chainguard/chainguard-images/reference/atlantis/tags_history.md
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,30 @@ | ||
--- | ||
title: "atlantis Image Tags History" | ||
type: "article" | ||
unlisted: true | ||
description: "Image Tags and History for the atlantis Chainguard Image" | ||
date: 2023-06-22T11:07:52+02:00 | ||
lastmod: 2023-06-22T11:07:52+02:00 | ||
draft: false | ||
tags: ["Reference", "Chainguard Images", "Product"] | ||
images: [] | ||
weight: 700 | ||
toc: true | ||
--- | ||
|
||
{{< tabs >}} | ||
{{< tab title="Overview" active=false url="/chainguard/chainguard-images/reference/atlantis/" >}} | ||
{{< tab title="Variants" active=false url="/chainguard/chainguard-images/reference/atlantis/image_specs/" >}} | ||
{{< tab title="Tags History" active=true url="/chainguard/chainguard-images/reference/atlantis/tags_history/" >}} | ||
{{< tab title="Provenance" active=false url="/chainguard/chainguard-images/reference/atlantis/provenance_info/" >}} | ||
{{</ tabs >}} | ||
|
||
The following table contains the most recent tags and digests that can be used to pin your Dockerfile to a specific build of this image. Check our guide on [Using the Tag History API](/chainguard/chainguard-images/using-the-tag-history-api/) for information on how to fetch all tags from an image and how to pin your Dockerfile to a specific digest. | ||
|
||
Please note that digests and timestamps only change when there is a change to the image, even though images are rebuilt every night. The "Last Changed" column indicates when the image was last modified, and doesn't always reflect the latest build timestamp. For more information about how our reproducible builds work, please refer to [this blog post](https://www.chainguard.dev/unchained/reproducing-chainguards-reproducible-image-builds). | ||
|
||
| Tag (s) | Last Changed | Digest | | ||
|---------------|--------------|---------------------------------------------------------------------------| | ||
| `latest-dev` | October 23rd | `sha256:0dbdb8c0b1ada1e52719ecb613c84fc3b5dfa79faf83324d2ddaaf294407d51c` | | ||
| `latest` | October 23rd | `sha256:12e5d26e373d72ee0547cb11c90a9257bfc96f677f6cf1ad008daa7a0553ca4c` | | ||
|
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
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
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
Oops, something went wrong.