add docs for container registry
This commit is contained in:
parent
34995be892
commit
d2a0710625
|
@ -8,6 +8,7 @@ available to CSC members.
|
||||||
* [CloudStack](cloudstack) - Virtual machines on demand.
|
* [CloudStack](cloudstack) - Virtual machines on demand.
|
||||||
* [Virtual hosting](vhosts) - Domain name routing for websites.
|
* [Virtual hosting](vhosts) - Domain name routing for websites.
|
||||||
* [Kubernetes](kubernetes) - Easily deploy your Dockerized apps.
|
* [Kubernetes](kubernetes) - Easily deploy your Dockerized apps.
|
||||||
|
* [Registry](registry) - A place to store your Docker images.
|
||||||
|
|
||||||
## Getting Started
|
## Getting Started
|
||||||
|
|
||||||
|
|
|
@ -0,0 +1,59 @@
|
||||||
|
# Registry
|
||||||
|
We are running an instance of [Harbor](https://goharbor.io/) at
|
||||||
|
[https://registry.cloud.csclub.uwaterloo.ca](https://registry.cloud.csclub.uwaterloo.ca).
|
||||||
|
Harbor is a container registry for uploading and downloading Docker images.
|
||||||
|
|
||||||
|
## Resource Limits
|
||||||
|
As of this writing, each member is restricted to a project with a 25GB
|
||||||
|
storage quota. Multiple images may be pushed to a project.
|
||||||
|
|
||||||
|
If you want more space, please send an email to syscom with a brief
|
||||||
|
justification.
|
||||||
|
|
||||||
|
## Logging in to the website
|
||||||
|
Just visit
|
||||||
|
[https://registry.cloud.csclub.uwaterloo.ca](https://registry.cloud.csclub.uwaterloo.ca)
|
||||||
|
and press the 'Login via OIDC Provider' button.
|
||||||
|
|
||||||
|
## Create a project
|
||||||
|
*After* you have logged in to Harbor, SSH into a CSC machine and run the
|
||||||
|
following:
|
||||||
|
```sh
|
||||||
|
ceo registry project create
|
||||||
|
```
|
||||||
|
Now refresh the Harbor page; you should see a project whose name is your
|
||||||
|
username. You are an admin of this project, so you can invite other
|
||||||
|
Harbor users to it if you wish.
|
||||||
|
|
||||||
|
## Logging in to the registry
|
||||||
|
From the Harbor UI, click the top left corner, click 'User Profile', and
|
||||||
|
copy the CLI secret.
|
||||||
|
|
||||||
|
From your personal computer, login to the registry:
|
||||||
|
```sh
|
||||||
|
docker login registry.cloud.csclub.uwaterloo.ca
|
||||||
|
```
|
||||||
|
Use your CSC username for the username; use the CLI secret you copied earlier
|
||||||
|
for the password.
|
||||||
|
|
||||||
|
## Pushing an image
|
||||||
|
Once you have logged into the registry, you can start pushing your own images.
|
||||||
|
|
||||||
|
Let's say you have an image which you created locally called
|
||||||
|
`myimage:0.1.0`. Create a new tag of your image for the CSC registry:
|
||||||
|
```sh
|
||||||
|
docker tag myimage:0.1.0 registry.cloud.csclub.uwaterloo.ca/your_username/myimage:0.1.0
|
||||||
|
```
|
||||||
|
(Replace `your_username` with your actual username.)
|
||||||
|
|
||||||
|
Now push it:
|
||||||
|
```sh
|
||||||
|
docker push registry.cloud.csclub.uwaterloo.ca/your_username/myimage:0.1.0
|
||||||
|
```
|
||||||
|
|
||||||
|
!!! tip
|
||||||
|
Keep your Docker images small. This speeds up your upload time, and makes
|
||||||
|
you less likely to reach your storage quota.
|
||||||
|
[Here](https://blog.codacy.com/five-ways-to-slim-your-docker-images/) are
|
||||||
|
some good suggestions; you can find plenty more online with a quick
|
||||||
|
Google search.
|
|
@ -6,6 +6,7 @@ nav:
|
||||||
- Virtual Hosting: vhosts.md
|
- Virtual Hosting: vhosts.md
|
||||||
- Kubernetes: kubernetes.md
|
- Kubernetes: kubernetes.md
|
||||||
- SSH Tricks: ssh-tricks.md
|
- SSH Tricks: ssh-tricks.md
|
||||||
|
- Registry: registry.md
|
||||||
|
|
||||||
# pip install pymdown-extensions
|
# pip install pymdown-extensions
|
||||||
markdown_extensions:
|
markdown_extensions:
|
||||||
|
|
Loading…
Reference in New Issue