{"id":37130947,"url":"https://github.com/gocd-contrib/docker-elastic-agents-plugin","last_synced_at":"2026-01-14T15:03:02.530Z","repository":{"id":48643938,"uuid":"49419637","full_name":"gocd-contrib/docker-elastic-agents-plugin","owner":"gocd-contrib","description":"Docker-based elastic agents for GoCD","archived":false,"fork":false,"pushed_at":"2026-01-01T07:04:18.000Z","size":2437,"stargazers_count":32,"open_issues_count":9,"forks_count":39,"subscribers_count":8,"default_branch":"master","last_synced_at":"2026-01-06T02:31:24.675Z","etag":null,"topics":["docker-plugin","elastic-agents","gocd","gocd-agent"],"latest_commit_sha":null,"homepage":"https://www.gocd.org","language":"Java","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/gocd-contrib.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2016-01-11T10:45:53.000Z","updated_at":"2026-01-01T07:04:15.000Z","dependencies_parsed_at":"2024-02-09T12:08:44.720Z","dependency_job_id":"193e53ec-9bd4-485b-880e-4aa074daab78","html_url":"https://github.com/gocd-contrib/docker-elastic-agents-plugin","commit_stats":null,"previous_names":[],"tags_count":273,"template":false,"template_full_name":null,"purl":"pkg:github/gocd-contrib/docker-elastic-agents-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gocd-contrib%2Fdocker-elastic-agents-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gocd-contrib%2Fdocker-elastic-agents-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gocd-contrib%2Fdocker-elastic-agents-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gocd-contrib%2Fdocker-elastic-agents-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gocd-contrib","download_url":"https://codeload.github.com/gocd-contrib/docker-elastic-agents-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gocd-contrib%2Fdocker-elastic-agents-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28424040,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T13:30:50.153Z","status":"ssl_error","status_checked_at":"2026-01-14T13:29:08.907Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["docker-plugin","elastic-agents","gocd","gocd-agent"],"created_at":"2026-01-14T15:03:01.978Z","updated_at":"2026-01-14T15:03:02.512Z","avatar_url":"https://github.com/gocd-contrib.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GoCD Elastic agent plugin for Docker\n\nTable of Contents\n=================\n\n  * [Installation](#installation)\n  * [Building the code base](#building-the-code-base)\n  * [Using your own docker image with elastic agents](#using-your-own-docker-image-with-elastic-agents)\n     * [Using the GoCD agent, installed via .deb/.rpm](#using-the-gocd-agent-installed-via-debrpm)\n     * [Use a custom bootstrapper](#use-a-custom-bootstrapper)\n  * [Troubleshooting](#troubleshooting)\n  * [Credits](#credits)\n  * [License](#license)\n\n## Installation\n\nDocumentation for installation is available [here](INSTALL.md).\n\n## Building the code base\n\nTo build the jar, run `./gradlew clean test assemble`\n\n## Using your own docker image with elastic agents\n\nThe plugin executes the equivalent of the following docker command to start the agent —\n\n```\ndocker run -e GO_EA_SERVER_URL=...\n           -e GO_EA_AUTO_REGISTER_KEY=...\n           -e GO_EA_AUTO_REGISTER_ENVIRONMENT=...\n           -e GO_EA_AUTO_REGISTER_ELASTIC_AGENT_ID=...\n           -e GO_EA_AUTO_REGISTER_ELASTIC_PLUGIN_ID=...\n           ...\n           IMAGE_ID\n```\n\nYour docker image is expected to contain a bootstrap program (to be executed via docker's `CMD`) that will create an [`autoregister.properties`](https://docs.gocd.io/current/advanced_usage/agent_auto_register.html) file using these variables. The `GO_EA_SERVER_URL` will point to the server url that the agent must communicate with.\n\nHere is an example shell script to do this —\n\n```bash\n# write out autoregister.properties\n(\ncat \u003c\u003cEOF\nagent.auto.register.key=${GO_EA_AUTO_REGISTER_KEY}\nagent.auto.register.environments=${GO_EA_AUTO_REGISTER_ENVIRONMENT}\nagent.auto.register.elasticAgent.agentId=${GO_EA_AUTO_REGISTER_ELASTIC_AGENT_ID}\nagent.auto.register.elasticAgent.pluginId=${GO_EA_AUTO_REGISTER_ELASTIC_PLUGIN_ID}\nEOF\n) \u003e /var/lib/go-agent/config/autoregister.properties\n```\n\n### Using the GoCD agent, installed via `.deb/.rpm`\n\nSee the bootstrap script and docker file here under [`contrib/scripts/bootstrap-via-installer`](contrib/scripts/bootstrap-via-installer).\n\n### Use a custom bootstrapper\n\nThis method uses lesser memory and boots up the agent process and starts off a build quickly:\n\nSee the bootstrap script and docker file here under [`contrib/scripts/bootstrap-without-installed-agent`](contrib/scripts/bootstrap-without-installed-agent).\n\n## Troubleshooting\n\n### Enable Debug Logs\n\n#### If you are on GoCD version 19.6 and above:\n\nEdit the file `wrapper-properties.conf` on your GoCD server and add the following options. The location of the `wrapper-properties.conf` can be found in the [installation documentation](https://docs.gocd.org/current/installation/installing_go_server.html) of the GoCD server.\n\n```properties\n# We recommend that you begin with the index `100` and increment the index for each system property\nwrapper.java.additional.100=-Dplugin.cd.go.contrib.elastic-agent.docker.log.level=debug\n```\n\nIf you're running with GoCD server 19.6 and above on docker using one of the supported GoCD server images, set the environment variable `GOCD_SERVER_JVM_OPTIONS`:\n\n```shell\ndocker run -e \"GOCD_SERVER_JVM_OPTIONS=-Dplugin.cd.go.contrib.elastic-agent.docker.log.level=debug\" ...\n```\n\n#### If you are on GoCD version 19.5 and lower:\n\n* On Linux:\n\n    Enabling debug level logging can help you troubleshoot an issue with this plugin. To enable debug level logs, edit the file `/etc/default/go-server` (for Linux) to add:\n\n    ```shell\n    export GO_SERVER_SYSTEM_PROPERTIES=\"$GO_SERVER_SYSTEM_PROPERTIES -Dplugin.cd.go.contrib.elastic-agent.docker.log.level=debug\"\n    ```\n\n    If you're running the server via `./server.sh` script:\n\n    ```shell\n    $ GO_SERVER_SYSTEM_PROPERTIES=\"-Dplugin.cd.go.contrib.elastic-agent.docker.log.level=debug\" ./server.sh\n    ```\n\n* On windows:\n\n    Edit the file `config/wrapper-properties.conf` inside the GoCD Server installation directory (typically `C:\\Program Files\\Go Server`):\n\n    ```\n    # config/wrapper-properties.conf\n    # since the last \"wrapper.java.additional\" index is 15, we use the next available index.\n    wrapper.java.additional.16=-Dplugin.cd.go.contrib.elastic-agent.docker.log.level=debug\n    ```\n\n## Credits\n\nThanks to @konpa for the [docker icon](https://raw.githubusercontent.com/konpa/devicon/b80c6d9acb7b58b80904769015f9e0dd36fe46d2/icons/docker/docker-plain.svg) used by the plugin.\n\n## License\n\n```plain\nCopyright 2022 Thoughtworks, Inc.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgocd-contrib%2Fdocker-elastic-agents-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgocd-contrib%2Fdocker-elastic-agents-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgocd-contrib%2Fdocker-elastic-agents-plugin/lists"}