Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation refinements #179

Merged
merged 1 commit into from
Sep 13, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions docs/all.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,8 @@ spec:

You can set a custom update strategy using [kubernetes Deployment update strategy](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#strategy) definitions.

NOTE: This applies to all resources that deploy Pods except for ChiaNodes.

```yaml
spec:
strategy:
Expand All @@ -125,6 +127,20 @@ spec:
maxUnavailable: 1
```

### ChiaNode Update Strategies

ChiaNodes deploy StatefulSet resources which use a different update strategy definition. See the documentation for [kubernetes StatefulSet update strategy](https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/#update-strategies) definitions.

```yaml
apiVersion: k8s.chia.net/v1
kind: ChiaNode
metadata:
name: my-node
spec:
updateStrategy:
type: RollingUpdate
```

## Configure Readiness, Liveness, and Startup probes

By default, if chia-exporter is enabled it comes with its own readiness and liveness probes. But you can configure readiness, liveness, and startup probes for the chia container in your deployed Pods, too:
Expand Down Expand Up @@ -175,3 +191,12 @@ type: kubernetes.io/dockerconfigjson
data:
.dockerconfigjson: <base64-encoded-auth-secret>
```

## Specify Image Pull Policy

If you need to specify your image pull policy for container images:

```yaml
spec:
imagePullPolicy: "IfNotPresent"
```
2 changes: 1 addition & 1 deletion docs/chiaca.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ spec:
secret: my-ca
```

This will create a kubernetes Secret in the same namespace that this CR is applied named `my-ca`. If you have your own pre-existing CA that you would like to continue using instead, you can also [create a kubernetes Secret manually, documented in this section of the readme.](https://github.com/Chia-Network/chia-operator/blob/main/README.md#ssl-ca).
This will create a kubernetes Secret in the same namespace that this CR is applied named `my-ca`. If you have your own pre-existing CA that you would like to continue using instead, you can also [create a kubernetes Secret manually, documented in this section of the readme](https://github.com/Chia-Network/chia-operator/blob/main/README.md#ssl-ca).

You can then supply this CA Secret to other Chia custom resources like so:

Expand Down
2 changes: 1 addition & 1 deletion docs/chiaharvester.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ spec:

## Plot storage

You can mount hostPath volumes or persistent volumes in a harvester pod using the following syntax. All claims/hostPaths get mounted as sub-directories of `/plots` in the container. Harvesters ran with this operator set the `recursive_plot_scan` option to true.
You can mount hostPath volumes or persistent volumes in a harvester pod using the following syntax. All claims/hostPaths get mounted as subdirectories of `/plots` in the container. Harvesters ran with this operator set the `recursive_plot_scan` option to true.

```yaml
spec:
Expand Down
2 changes: 1 addition & 1 deletion docs/chiaintroducer.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Specifying a ChiaIntroducer will create a kubernetes Deployment and some Services for a Chia introducer.

The majority of people do not need to run a introducer. Introducers in Chia serve the purpose of introducing full_nodes in a network to other full_node peers on that network.
The majority of people do not need to run an introducer. Introducers in Chia serve the purpose of introducing full_nodes in a network to other full_node peers on that network.

Here's a ChiaIntroducer example custom resource (CR):

Expand Down
2 changes: 1 addition & 1 deletion docs/chiaseeder.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Specifying a ChiaSeeder will create a kubernetes Deployment and some Services fo

The majority of people do not need to run a seeder. Seeders in Chia serve the purpose of introducing full_nodes in a network to other full_node peers on that network. See the [seeder documentation](https://docs.chia.net/guides/seeder-user-guide/) for more information.

Seeders have some pre-requisites that you will normally configure outside of a kubernetes cluster. This operator doesn't do any of that configuration on your behalf, so in short you will need:
Seeders have some pre-requisites that you will normally configure outside a kubernetes cluster. This operator doesn't do any of that configuration on your behalf, so in short you will need:

* A DNS `A` record that points to your server's IP address. In this instance the A record will probably be your public IP address if you intend on the DNS server to be reachable publicly, or an internal address if you're reserving the seeder's DNS server for your use.
* A DNS `AAAA` record is not strictly needed, but is often preferred if your network is IPv6 enabled.
Expand Down
28 changes: 27 additions & 1 deletion docs/chiawallet.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,12 +30,38 @@ kind: Secret
metadata:
name: chiakey-secret
stringData:
key.txt: your mnemonic goes here
key.txt: "your mnemonic goes here"
type: Opaque
```

Replace the text value for `key.txt` with your mnemonic, and then reference it in your ChiaWallet resource in the way shown above.

## Full Node Peer

You may optionally specify a local full_node for a peer to sync your wallet from.

```yaml
spec:
chia:
fullNodePeer: "node.default.svc.cluster.local:8444"
```

## Trusted Peers

You can optionally specify a list of [CIDRs](https://aws.amazon.com/what-is/cidr/) that the wallet should trust full_node peers from. View the [Chia documentation on trusted peers](https://docs.chia.net/faq/?_highlight=trust#what-are-trusted-peers-and-how-do-i-add-them) to understand whether you should use this feature or not.

Here's an example ChiaWallet that specifies trusted CIDRs:

```yaml
spec:
chia:
trustedCIDRs:
- "192.168.1.0/24"
- "10.0.0/8"
```

This specifies two trusted CIDRs, where if the IP address of a full_node peer is discovered to be within one of these two CIDR ranges, chia will consider that a trusted peer.

## More Info

This page contains documentation specific to this resource. Please see the rest of the documentation for information on more available configurations.
Expand Down
2 changes: 1 addition & 1 deletion docs/install.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Installation

There are two parts to this Operator. The CRDs (ChiaCA, ChiaFarmer, ChiaNode, etc) and the actual operator manager Deployment and related objects. You can install these components in two methods, either by cloning the repository and generating the manifests yourself with kustomize, or with `kubectl apply` on the generated manifests on all releases, starting with release `0.2.1`.
There are two parts to this Operator. The CRDs (ChiaCA, ChiaFarmer, ChiaNode, etc.) and the actual operator manager Deployment and related objects. You can install these components in two methods, either by cloning the repository and generating the manifests yourself with kustomize, or with `kubectl apply` on the generated manifests on all releases, starting with release `0.2.1`.

## Using the release manifests

Expand Down
3 changes: 3 additions & 0 deletions docs/services-networking.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ metadata:
spec:
chia:
caSecretName: chiaca-secret
allService:
enabled: true
type: ClusterIP
peerService:
enabled: true
type: LoadBalancer
Expand Down