[{"_1":2,"_162":-5,"_163":-5},"loaderData",{"_3":4,"_18":19,"_26":27,"_141":142},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16,"_17":11},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","dockerRebrandTour","routes/_layout",{"_20":-5,"_21":22,"_23":22,"_24":11,"_25":22},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_28":29,"_30":-5,"_31":11,"_32":11,"_33":34,"_35":36,"_37":-5,"_38":11,"_39":40,"_89":-5,"_90":91,"_129":-5,"_130":11,"_131":22,"_132":11,"_133":11,"_134":-5,"_135":11,"_136":-5,"_137":138,"_139":92,"_140":-7},"canonicalUrl","https://hub.docker.com/r/dspfac/discover/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","dspfac","reponame","discover","cloudBuildSource","isAutobuildsAvailable","repo",{"_41":42,"_43":44,"_46":47,"_48":49,"_50":11,"_51":52,"_53":54,"_55":56,"_58":36,"_33":34,"_59":60,"_61":-5,"_62":63,"_64":65,"_66":67,"_68":-5,"_69":63,"_70":71,"_72":11,"_73":34,"_74":75,"_80":22,"_81":82,"_86":34,"_87":88},"categories",[],"content_types",[45],"image","date_registered","2014-10-05T06:28:39.032118Z","description","","is_private","last_updated","2015-11-13T10:53:20.085028Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[57],"application/vnd.docker.distribution.manifest.v1+prettyjws","name","pull_count",1185,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","Discover: Docker Service Discovery\n========\n\n[![Build Status](https://travis-ci.org/totem/discover.png?branch=master)](https://travis-ci.org/totem/discover)\n\nThis service watches [Docker](http://docker.io) for containers starting and stopping to publish any advertised services out to [Etcd](https://github.com/coreos/etcd). At this time, consumption of the published services can be done by querying Etcd directly. There are however plans to develop client libraries making this trivial.\n\nThe discovery of services is done by inspecting a custom ENV variable defined in the Dockerfile of the container. The ENV variable describes the service names and local ports they can be found on. Discover translates these to the public IP / Port assigned by Docker.\n\n## How It Works\n\nDiscover uses Etcd, a REST based highly-available key/value store, as it's service registry. The best way to understand what Discover does is by walking through the lifecycle of a Docker container start/stop event. *Note: This example assumes you already have Etcd and Discover running and properly configured.*\n\n### Container Configuration\n\nGiven the following `Dockerfile` that has been build using `docker build -t static-web-server .`:\n\n```\nFROM totem/ubuntu:raring\n\nRUN apt-get update --fix-missing && apt-get upgrade -y\nRUN apt-get install -y wget curl build-essential patch git-core openssl libssl-dev unzip ca-certificates python python-dev python-pip\n\nRUN curl http://nodejs.org/dist/v0.10.25/node-v0.10.25-linux-x64.tar.gz | tar xzvf - --strip-components=1 -C \"/usr\"\n\nRUN apt-get clean && rm -rf /var/cache/apt/archives/* /var/lib/apt/lists/*\n\nRUN npm install -g node-static\n\nENV DISCOVER static-web-server:8080\n\nENTRYPOINT [\"static\"]\n```\n\n### Service Discovery and Publication\n\nUpon starting the container using `docker run -d -p 8080 static-web-server`, Docker will emit a start event for this container. Discover will listen for this event. Upon receiving the event, Discover will inspect the started container looking for a ENV variable matching the value of the `discover:serviceVariable` configuration variable. By default, this value will be `DISCOVER`.\n\nIn the case of our example, this ENV variable is set to `static-web-server:8080`. Discover will read this value and determine that the container that just started is exposing a service named `static-web-server` and it can be found on the private container port of 8080. *Note: by default tcp is assumed, however you can explcitly specify if the port is expecting tcp or udp.*\n\nNow that Discover knows the service name and port, it will register the service with Etcd at the following location:\n\n```\n//service/static-web-server///\n```\n\nWhere:\n\n- ``: Defined in the configuration of Discover. By default this is `/discover`.\n- ``: Defined in the configuration of Discover. Used to segment services into logical groups.\n- ``: Identifier of the host this service was deployed on. This is determined using a strategy of a custom configuration value, then the AWS instance-id if availalbe, and lastly falling back to the hostname of the machine.\n- ``: This is the short 12 byte Docker container ID hosting the service.\n\nThe value stored at the above path will look like:\n```\n://:\n```\n\nWhere:\n\n- ``: The protocol expected at the IP/Port. Valid values are `tcp` or `udp`.\n- ``: The publicly routable IP address for the host machine.\n- ``: The port assigned by Docker that maps to the internal port defined by the service.\n\n### Multiple Service Lookup\n\nSince multiple services can be publicized under the same name, you can lookup all available services by broadaining the path you query. For example, a `GET /discover/service/static-web-server/my-realm?recursive=true` will return a list of all services with the name `static-web-server` that have been published in the realm `my-realm`.\n\n## Publishing Services\n\nPublishing services from a Docker container using Discover is simple. Simply define each service in the appropriate ENV variable, seperated by commas.\n\nFor example, to publish two services from a single container where `service1` is listening on 8080/tcp and `service2` is listening on 8125/udp you would specify the following ENV variable in your Dockerfile:\n\n```\nENV DISCOVER service1:8080, service2:8125/udp\n```\n\n## Configuration\n\nThe following configuration options are available:\n\n- `config`: path to JSON file defining custom configuration\n- `discover`\n - `serviceVariable`: name of the ENV variable to inspect in started containers for published services. Default: *DISCOVER*\n- `docker`\n - `port`: port to connect to Docker API on. Default: *4243*\n - `host`: host to connect to Docker API on. Default: *localhost*\n - `version`: API version to target. Default: *v1.8*\n - `socketPath`: path to Docker socket on host. Use of this overrides host/port. Default: *false*\n- `etcd`\n - `port`: port to connect to Etcd on. Default: *4001*\n - `host`: host to connect to Etcd on. Default: *localhost*\n - `prefix`': the prefix to use for all Etcd registry entries. Default: */discover/*\n- `host`:\n - `ip`: the public IP address of the host to use for service routing. Default: IPv4 address of eth0\n - `realm`: name of the realm this instance of Discover is deployed in. Default: *default*\n - `id`: the unique ID of the host this instance of Discover is deployed to. Default: the AWS instance-id if available, falling back to the hostname of the machine\n- `debug`: enable debug logging\n- `verbose`: enable verbose logging\n- `silly`: enable silly logging\n- `log`: path of file to redirect log output to\n\n### Configuration via CLI\n\nFor any configuration value above, you can specify the value on the command line. For example, to set the realm of the host to `my-realm` you would specify `--host:realm my-realm` on the CLI.\n\n### Configuration via File\n\nHere is an example configuration file `config.json`:\n\n```js\n{\n \"host\": {\n \"realm\": \"my-realm\"\n }\n}\n```\n\nTo use this file you would start Discover using the CLI option `--config config.json`.\n\n## Running Discover\n\nDiscover has dependencies on Docker and Etcd. It's designed to run one instance of Discover per instance of Docker, and idealy on the same machine that Docker is running on. Etcd does not need to be running on the same machine as Discover.\n\nThe setup of Docker and Etcd are outside of the scope of this document.\n\nOnce Docker and Etcd are setup, installing and running Discover is as simple as:\n\n```bash\nnpm install -g docker-discover\ndiscover --config config-file.json\n```\n","has_starred","hub_user","immutable_tags_settings",{"_76":11,"_77":78},"enabled","rules",[79],".*","is_automated","permissions",{"_83":22,"_84":11,"_85":11},"read","write","admin","user","storage_size",233863621,"orgData","recentTags",[92],{"_93":45,"_94":95,"_96":97,"_98":99,"_100":101,"_102":103,"_51":118,"_119":95,"_120":34,"_121":57,"_58":122,"_123":124,"_125":109,"_126":118,"_127":67,"_128":22},"content_type","creator",22962,"digest","sha256:0ef6b32b8a68ae0d19f5a7e19504c6362cdef246e6f1dd45552eafffb97fb08c","full_size",233804005,"id",72712,"images",[104],{"_105":106,"_96":97,"_107":49,"_108":109,"_110":111,"_112":49,"_113":49,"_114":-5,"_115":116,"_64":67,"_117":-5},"architecture","amd64","features","last_pulled","2026-10-20T11:10:50.541377562Z","last_pushed","2015-11-13T10:53:18Z","os","os_features","os_version","size",233804485,"variant","2015-11-13T10:53:25.826781Z","last_updater","last_updater_username","media_type","latest","repository",63246,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_39":143,"_150":151,"_137":160,"_161":11},{"_41":144,"_43":145,"_46":47,"_48":49,"_50":11,"_51":52,"_53":54,"_55":146,"_58":36,"_33":34,"_59":60,"_61":-5,"_62":63,"_64":65,"_66":67,"_68":-5,"_69":63,"_70":71,"_72":11,"_73":34,"_74":147,"_80":22,"_81":149,"_86":34,"_87":88},[],[45],[57],{"_76":11,"_77":148},[79],{"_83":22,"_84":11,"_85":11},"tags",{"_152":65,"_153":-5,"_154":-5,"_155":156},"count","next","previous","results",[157],{"_93":45,"_94":95,"_96":97,"_98":99,"_100":101,"_102":158,"_51":118,"_119":95,"_120":34,"_121":57,"_58":122,"_123":124,"_125":109,"_126":118,"_127":67,"_128":22},[159],{"_105":106,"_96":97,"_107":49,"_108":109,"_110":111,"_112":49,"_113":49,"_114":-5,"_115":116,"_64":67,"_117":-5},[],"canDeleteTags","actionData","errors"]

dspfac/discover

Tags for dspfac/discover