{"id":20730161,"url":"https://github.com/containerssh/images","last_synced_at":"2025-04-23T21:22:20.382Z","repository":{"id":103056456,"uuid":"348601017","full_name":"ContainerSSH/images","owner":"ContainerSSH","description":"The ContainerSSH container images","archived":false,"fork":false,"pushed_at":"2025-01-19T20:24:41.000Z","size":80,"stargazers_count":3,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-30T03:41:12.318Z","etag":null,"topics":["devsecops","docker","kubernetes","security","ssh"],"latest_commit_sha":null,"homepage":"https://containerssh.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ContainerSSH.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-17T06:19:14.000Z","updated_at":"2025-01-19T20:24:33.000Z","dependencies_parsed_at":"2024-01-07T13:40:46.750Z","dependency_job_id":"ad0cf547-13b5-48e3-84c9-2a34acfead8f","html_url":"https://github.com/ContainerSSH/images","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ContainerSSH%2Fimages","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ContainerSSH%2Fimages/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ContainerSSH%2Fimages/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ContainerSSH%2Fimages/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ContainerSSH","download_url":"https://codeload.github.com/ContainerSSH/images/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250515326,"owners_count":21443371,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["devsecops","docker","kubernetes","security","ssh"],"created_at":"2024-11-17T05:10:04.128Z","updated_at":"2025-04-23T21:22:20.367Z","avatar_url":"https://github.com/ContainerSSH.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![ContainerSSH - Launch Containers on Demand](https://containerssh.github.io/images/logo-for-embedding.svg)](https://containerssh.github.io/)\n\n\u003c!--suppress HtmlDeprecatedAttribute --\u003e\n\u003ch1 align=\"center\"\u003eContainerSSH Container Image Repository\u003c/h1\u003e\n\nThis repository contains the scripts that build the ContainerSSH container images.\n\n\u003cp align=\"center\"\u003e\u003cstrong\u003e⚠⚠⚠ Warning: This is a developer repository. ⚠⚠⚠\u003c/strong\u003e\u003cbr /\u003eThe user documentation for ContainerSSH is located at \u003ca href=\"https://containerssh.io\"\u003econtainerssh.io\u003c/a\u003e.\u003c/p\u003e\n\n## How this repository works\n\nThis repository contains a build script in Go called `build.go`. It can be invoked by running `go run build.go`. This script will read [build.yaml](build.yaml) and build the container image based on that revision. It uses the GitHub API to download release artifacts, so it may need the `GITHUB_TOKEN` environment variable set. The optional `--push` flag can be set to push the images to the corresponding registries.\n\nUnder the hood the build uses [`docker-compose`](https://docs.docker.com/compose/) to build, test, and push the images. The build steps can be performed manually.\n\nBefore you begin you must set several environment variables. These are the following:\n\n| Variable | Required | Description|\n|----------|----------|------------|\n| `CONTAINERSSH_VERSION` | Yes | Sets the ContainerSSH version to download. |\n| `CONTAINERSSH_TAG_VERSION` | Yes | Sets the container image tag suffix to create. (See the [Versioning section](#versioning) below.) | \n| `REGISTRY` | No | Sets the registry prefix to push to. For example, `quay.io/`. Defaults to the Docker hub. |\n| `GITHUB_TOKEN` | No | Sets the GitHub access token to work around anonymous rate limits. |\n| `SOURCE_REPO` | No | Sets the source URL for downloads. Defaults to `https://github.com/ContainerSSH/ContainerSSH`. |\n\nFor example, on Linux/MacOS:\n\n```bash\nCONTAINERSSH_VERSION=\"0.3.1\"\nCONTAINERSSH_TAG=\"0.3.1\"\n```\n\nOn Windows/PowerShell:\n\n```ps1\n$env:CONTAINERSSH_VERSION=\"0.3.1\"\n$env:CONTAINERSSH_TAG=\"0.3.1\"\n```\n\n### Build\n\nThe build step requires build arguments to function. At the very least it should contain the `CONTAINERSSH_VERSION` variable so that the build knows which ContainerSSH release to download.\n\nOptionally, you can also specify a `GITHUB_TOKEN` to work around GitHub rate limits and `SOURCE_REPO` to point the build to a different source URL.\n\n```bash\ndocker-compose build\n``` \n\n### Test\n\nTesting is done via a container called `sut`. This container will wait for ContainerSSH to come up and then run a simple SSH connection to it to test that it works correctly. This is not a comprehensive test, but checks if the image build was successful.\n\n```\ndocker-compose up --abort-on-container-exit --exit-code-from=sut\n```\n\n### Clean up after test\n\n```\ndocker-compose down\n```\n\n### Push\n\nFinally, pushing container images can also be done from `docker-compose`. After a `docker login` command this can be simply done using the following command:\n\n```\ndocker-compose push\n```\n\n## Versioning\n\nContainerSSH container images are versioned independently of ContainerSSH. This allows for more frequent rebuilds of the image than we have ContainerSSH releases. This is important because we want our users to have frequent security updates. Therefore, the build script creates multiple tags for the image.\n\nLet's take version 0.4.0, for example. Let's say the [build.yaml](build.yaml) contains the following configuration:\n\n```yaml\nrevision: 20200318\nversions:\n  0.4.0:\n   - latest\n   - 0.4\n   - 0.4.0\n```\n\nIn this case the build script would create the following tags:\n\n- latest\n- 0.4\n- 0.4-20200318\n- 0.4.0\n- 0.4.0-20200318\n\nUsers can safely rely on the tag with the ContainerSSH version, or can specify a very specific build version should they need to pin to an immutable version.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainerssh%2Fimages","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontainerssh%2Fimages","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainerssh%2Fimages/lists"}