heartwood/radicle-cli/examples/rad-block.md at a04381f4e5fdff04a2f9bfa15a16d2addbcbe8a7

mirror of https://seed.radicle.dev/rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5.git synced 2026-10-31 00:40:50 +08:00

Files

T

Alexis Sellier 3ae7e305bd node: Simplify configuration

This is a change to the `config.json` file which removes certain options
that are best not touched and changes some options to make them easier
to work with.

1. We change the default journaling mode to "wal" and remove the config
   option.
2. We remove the option to set the peer connection "target", as it's not
   a good idea to set this to a different value, as it affects the
   network.
3. We combine seeding policy & scope, since there's no need to set the
   scope when the policy is "block". In that case, we always want to
   block "all" remotes. The new policy configuration has the following
   schema:

   { seedingPolicy: { default: "block" | "allow", scope?: "all" | "followed" } }

   The "scope" key is not used when "default" is set to "block".

4. We add an `extra` field to the node config for options that are not
   recognized. We use this to warn the user.

2024-06-04 14:08:15 +02:00

1.6 KiB

Raw Blame History

When using an open seeding policy, it can be useful to block individual repositories from being seeded.

For instance, if our default policy is to seed, any unknown repository will have its policy set to allow seeding:

$ rad inspect rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji --policy
Repository rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji is being seeded with scope `all`

Since there is no policy specific to this repository, there's nothing to be removed.

$ rad seed
No seeding policies to show.

But if we wanted to prevent this repository from being seeded, while allowing all other repositories, we could use rad block:

$ rad block rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji
✓ Policy for rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji set to 'block'

We can see that it is now no longer seeded:

$ rad inspect rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji --policy
Repository rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji is not being seeded

And a 'block' policy was added:

$ rad seed
╭───────────────────────────────────────────────────────────╮
│ Repository                          Name   Policy   Scope │
├───────────────────────────────────────────────────────────┤
│ rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji          block    all   │
╰───────────────────────────────────────────────────────────╯

1.6 KiB Raw Blame History

1.6 KiB

Raw Blame History