|
1 | | -Simple CLI to Deploy Static Websites to S5 |
| 1 | +<h1 align="center">S5 Deploy</h1> |
| 2 | +<div align="center"> |
| 3 | + <strong> |
| 4 | + Simple CLI to Deploy Static Websites to S5 |
| 5 | + </strong> |
| 6 | +</div> |
2 | 7 |
|
3 | | -⚠️⚠️⚠️ This project is under development, use with caution ⚠️⚠️⚠️ |
| 8 | + |
4 | 9 |
|
5 | | -### Acknowledgement |
| 10 | +## Install |
| 11 | + |
| 12 | +**Single line install**: |
| 13 | + |
| 14 | +```bash |
| 15 | +bash <(curl -s https://raw.githubusercontent.com/s5-dev/s5_deploy/main/install.sh) |
| 16 | +``` |
| 17 | + |
| 18 | +**Compile Yourself**: |
| 19 | +[Install dart](https://dart.dev/get-dart#install) first. |
| 20 | + |
| 21 | +``` |
| 22 | +git clone https://github.com/s5-dev/s5_deploy.git |
| 23 | +cd s5_deploy |
| 24 | +dart compile exe bin/s5_deploy.dart |
| 25 | +sudo mv ./bin/s5_deploy.exe /usr/local/bin/s5_deploy |
| 26 | +``` |
| 27 | + |
| 28 | +## Usage |
| 29 | + |
| 30 | +``` |
| 31 | +s5_deploy ./file/or/folder |
| 32 | +-V, --version Gets the version number of package |
| 33 | +-h, --help Print help dialoge. |
| 34 | + --reset Resets local node BE CAREFUL |
| 35 | + --static Skips resolver deploy |
| 36 | +-n, --node Which S5 node to deploy to |
| 37 | + (defaults to "https://s5.ninja") |
| 38 | +-S, --seed Set seed to recover DNS Link Entry |
| 39 | +-d, --dataKey Set the dataKey of the upload, defaults to target directory |
| 40 | +``` |
| 41 | + |
| 42 | +### Guide to Resolver Links |
| 43 | + |
| 44 | +For more details on the internals, read the [S5 Docs](https://docs.sfive.net/concepts/registry.html). |
| 45 | + |
| 46 | +Resolver Links are a S5 [CID](https://docs.sfive.net/concepts/content-addressed-data.html) that point to a mutable registry entry as opposed to a static dataset. This means they can be updated in the future if you wish to update the contents without changing the link. This can be especially useful when used in conjunction with [DNSLink](https://dnslink.org/) to deploy static websites to traditional domains. |
| 47 | + |
| 48 | +These Resolver Links are generated with 2 components, the user seed and the corresponding dataKey. In this implementation the dataKey is directly derived from the absolute path of the directory. So as long as the path and seed don't change, s5_deploy will automatically update the registry entry without any configuration. The ability to pass a dataKey and seed exist as well if you want to change the data path or machine. |
| 49 | + |
| 50 | +## Acknowledgement |
6 | 51 |
|
7 | 52 | This work is supported by a [Sia Foundation](https://sia.tech/) grant |
0 commit comments