35 lines
1.2 KiB
Markdown
35 lines
1.2 KiB
Markdown
# ipcr-hello
|
|
|
|
The IPCR Forge example. A tag on this repository builds its image, IPCR publishes it on IPFS,
|
|
and the repository is mirrored to Radicle.
|
|
|
|
## Try it
|
|
|
|
1. **Tag a release.** In Gitea: *Tags → New tag* (or *Releases → New release*), name it `v1.0.0`
|
|
and target `main`. From a clone it works too:
|
|
|
|
```sh
|
|
git tag v1.0.0 && git push origin v1.0.0
|
|
```
|
|
|
|
2. **Watch the build** under *Actions*. The first build on a new server takes a few minutes more,
|
|
while it downloads its build images.
|
|
|
|
3. **Find the image** on the forge's page (`ipcr-forge-<your domain>`, *Published images*), about
|
|
a minute after the build finishes. Then on this server or on any other running IPCR:
|
|
|
|
```yaml
|
|
services:
|
|
hello:
|
|
image: ipcr.localhost:4767/ipns/<forge name>/gitea_admin/ipcr-hello:1.0.0
|
|
ports: ["8080:8080"]
|
|
```
|
|
|
|
## What makes it work
|
|
|
|
- [`.gitea/workflows/build.yml`](.gitea/workflows/build.yml) pushes to `localhost:5000`, the
|
|
forge's staging registry. IPCR imports every tag it finds there.
|
|
- [`Dockerfile`](Dockerfile) is an ordinary Dockerfile. Anything that builds works.
|
|
|
|
Copy the workflow into any public or private repository on this forge to publish it the same way.
|