{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"The CGC Image Registry","type":"basic","slug":"the-cgc-image-registry","excerpt":"Store images containing tools","body":"##STORE IMAGES CONTAINING TOOLS \n\nThe **CGC image registry** is a secure storage facility in the same data center as the CGC compute nodes. It is used to store [Docker images](doc:docker-basics) containing tools. Images there can be accessed by the CGC, in order to run the tools in the containers that the images are snapshots of. \n\nAlternatively, Docker's own image registry, Docker Hub, can be used to store images. Images stored in Docker Hub can also be accessed from the CGC. \n\nTo make your tools  available on the CGC, you should upload [Docker images](doc:docker-basics) containing them to Docker Hub or to the CGC Image Registry. \n\nThe CGC image registry is `cgc-images.sbgenomics.com`.\n\nNote that the image registry `cgc-images.sbgenomics.com` is the location of your Docker images on the CGC. This doesn't point to a webpage, so you can't open `cgc-images.sbgenomics.com` in your browser.\n\n##Repositories in the CGC Image Registry\n\nImages in the Seven Bridges registry are arranged in **repositories**.\n\n## Repository paths\n\nIn order to upload an image to the the CGC Image Registry, or run a tool from an image contained there, you will need to refer to the repository in which the image is housed. Each image is uniquely identified using its full repository path:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"cgc-images.sbgenomics.com/<username>/<repository_name>[:tag]\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\nThis path consists of the following parts:\n* `cgc-images.sbgenomics.com`: URL of the CGC image registry.\n* `<username>`: Your CGC username.\n* `<repository_name>`: [Repository name](#section-repository-names). \n* `[:tag]`: Optional, commonly used to label the version of the image.\n\nYou will need to do this on the [Tool Editor](doc:the-tool-editor) in order to refer to the image containing your tool, if the image is stored in the CGC image registry. If the image is stored in Docker Hub, you can enter just the Docker Hub repository instead.\n\n## Repository names\n\nRepository names are user-defined, must be at least 3 characters long and can only contain lowercase letters, numbers, `.`, `-` and `_`.\n\n## Image tags\n\nA repository can house multiple images. To identify images, each image can be given a unique **tag**. You can use a numerical tagging system, or use words or phrases as tags. If you do not specify a tag, the default tag is `latest`.\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"body\": \"Please be aware that new repositories that are pushed to the CGC image registry have their privacy set to **Public** by default. Images in a public repository can be read by anybody who knows or can guess the name of the repository. For this reason, we recommend that you [set the repository privacy](manage-docker-repositories#section-adjust-privacy-settings) to **Private** or don't put sensitive data into containers whose images are stored in the CGC image registry.\"\n}\n[/block]","updates":["56cf44618acacb130081487b","56cf44f2287eb20b009f9eeb","56d4c5e38001e30b00896fc1"],"order":4,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5637e74acfaa870d00cdeb7a","__v":26,"category":{"sync":{"isSync":false,"url":""},"pages":["56268b3cc2781f0d00364bc0","5637bfa84dbdd919001b277d","5637e6fe97666c0d008656b6","5637e74acfaa870d00cdeb7a","5637e764f7e3990d007b2c52","5640baf604c3eb0d006fc43c","56cccb6894c8f00b00b83f24","56ddf68dba70f50e0033c6df"],"title":"DOCKER","slug":"bring-your-tools","order":16,"from_sync":false,"reference":false,"_id":"55faf958d0e22017005b8274","__v":8,"createdAt":"2015-09-17T17:33:12.687Z","project":"55faf11ba62ba1170021a9a7","version":"55faf11ba62ba1170021a9aa"},"createdAt":"2015-11-02T22:44:26.577Z","githubsync":"","parentDoc":null,"version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77","59a555bccdbd85001bfb1442","5a2a81f688574d001e9934f5","5b080c8d7833b20003ddbb6f","5c222bed4bc358002f21459a","5c22412594a2a5005cc9e919","5c41ae1c33592700190a291e","5c8a525e2ba7b2003f9b153c","5cbf14d58c79c700ef2b502e","5db6f03a6e187c006f667fa4"],"_id":"55faf11ba62ba1170021a9aa","releaseDate":"2015-09-17T16:58:03.490Z","createdAt":"2015-09-17T16:58:03.490Z","project":"55faf11ba62ba1170021a9a7","__v":46},"project":"55faf11ba62ba1170021a9a7","user":"554340dfb7f4540d00fcef1d"}

The CGC Image Registry

Store images containing tools

##STORE IMAGES CONTAINING TOOLS The **CGC image registry** is a secure storage facility in the same data center as the CGC compute nodes. It is used to store [Docker images](doc:docker-basics) containing tools. Images there can be accessed by the CGC, in order to run the tools in the containers that the images are snapshots of. Alternatively, Docker's own image registry, Docker Hub, can be used to store images. Images stored in Docker Hub can also be accessed from the CGC. To make your tools available on the CGC, you should upload [Docker images](doc:docker-basics) containing them to Docker Hub or to the CGC Image Registry. The CGC image registry is `cgc-images.sbgenomics.com`. Note that the image registry `cgc-images.sbgenomics.com` is the location of your Docker images on the CGC. This doesn't point to a webpage, so you can't open `cgc-images.sbgenomics.com` in your browser. ##Repositories in the CGC Image Registry Images in the Seven Bridges registry are arranged in **repositories**. ## Repository paths In order to upload an image to the the CGC Image Registry, or run a tool from an image contained there, you will need to refer to the repository in which the image is housed. Each image is uniquely identified using its full repository path: [block:code] { "codes": [ { "code": "cgc-images.sbgenomics.com/<username>/<repository_name>[:tag]", "language": "text" } ] } [/block] This path consists of the following parts: * `cgc-images.sbgenomics.com`: URL of the CGC image registry. * `<username>`: Your CGC username. * `<repository_name>`: [Repository name](#section-repository-names). * `[:tag]`: Optional, commonly used to label the version of the image. You will need to do this on the [Tool Editor](doc:the-tool-editor) in order to refer to the image containing your tool, if the image is stored in the CGC image registry. If the image is stored in Docker Hub, you can enter just the Docker Hub repository instead. ## Repository names Repository names are user-defined, must be at least 3 characters long and can only contain lowercase letters, numbers, `.`, `-` and `_`. ## Image tags A repository can house multiple images. To identify images, each image can be given a unique **tag**. You can use a numerical tagging system, or use words or phrases as tags. If you do not specify a tag, the default tag is `latest`. [block:callout] { "type": "danger", "body": "Please be aware that new repositories that are pushed to the CGC image registry have their privacy set to **Public** by default. Images in a public repository can be read by anybody who knows or can guess the name of the repository. For this reason, we recommend that you [set the repository privacy](manage-docker-repositories#section-adjust-privacy-settings) to **Private** or don't put sensitive data into containers whose images are stored in the CGC image registry." } [/block]