New OPS-centric setup. Integrated with wild-init
and wild-setup
.
This commit is contained in:
@@ -1,91 +1,16 @@
|
||||
# Setting Up Your Wild-cloud
|
||||
|
||||
## Initial setup
|
||||
Add the `bin` directory to your path.
|
||||
|
||||
- Add `bin` directory to your path.
|
||||
|
||||
## Set up your personal cloud operations directory
|
||||
Initialize a personal wild-cloud in any empty directory, for example:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
mkdir ~/my-wild-cloud
|
||||
cd my-wild-cloud
|
||||
wild-init
|
||||
cp config.example.yaml config.yaml
|
||||
cp secrets.example.yaml secrets.yaml
|
||||
```
|
||||
|
||||
## Configuring your wild-cloud
|
||||
Now, continue setup by following the instructions inside the new `README.md` in your personal wild-cloud directory:
|
||||
|
||||
Now, update your config.yaml and secrets.yaml.
|
||||
|
||||
Instructions TBD.
|
||||
|
||||
## Set up your Cloud Central
|
||||
|
||||
```bash
|
||||
bin/wild-central-generate-setup
|
||||
```
|
||||
|
||||
## Set up Control Nodes
|
||||
|
||||
### 2. Install K3s (Lightweight Kubernetes)
|
||||
|
||||
See [Cluster Node Setup](../cluster-node-setup/README.md).
|
||||
|
||||
## Install Infrastructure Components
|
||||
|
||||
> Currently, these are set up to run from this directory. This will be moved to (1) a `bin/wild-generate-infrastructure-setup` script to copy them all to your personal cloud dir, (2) `wild-cli` (to do the same), or (3) `wild-central`, once I get my mind made up.
|
||||
|
||||
One command sets up your entire cloud infrastructure:
|
||||
|
||||
```bash
|
||||
./infrastructure_setup/setup-all.sh
|
||||
```
|
||||
|
||||
This installs and configures:
|
||||
|
||||
- **MetalLB**: Provides IP addresses for services
|
||||
- **LongHorn**: Provides distributed block storage on the cluster
|
||||
- **Traefik**: Handles ingress (routing) with automatic HTTPS
|
||||
- **cert-manager**: Manages TLS certificates automatically
|
||||
- **CoreDNS**: Provides internal DNS resolution
|
||||
- **ExternalDNS**: Updates DNS records automatically
|
||||
- **Kubernetes Dashboard**: Web UI for managing your cluster
|
||||
|
||||
## Next Steps
|
||||
|
||||
Now that your infrastructure is set up, you can:
|
||||
|
||||
1. **Deploy Applications**: See [Applications Guide](./APPS.md) for deploying services and applications
|
||||
2. **Access Dashboard**: Visit `https://dashboard.internal.yourdomain.com` and use the token from `./bin/dashboard-token`
|
||||
3. **Validate Setup**: Run `./infrastructure_setup/validate_setup.sh` to ensure everything is working
|
||||
|
||||
## Validation and Troubleshooting
|
||||
|
||||
Run the validation script to ensure everything is working correctly:
|
||||
|
||||
```bash
|
||||
./infrastructure_setup/validate_setup.sh
|
||||
```
|
||||
|
||||
This script checks:
|
||||
|
||||
- All infrastructure components
|
||||
- DNS resolution
|
||||
- Service connectivity
|
||||
- Certificate issuance
|
||||
- Network configuration
|
||||
|
||||
If issues are found, the script provides specific remediation steps.
|
||||
|
||||
## What's Next?
|
||||
|
||||
Now that your personal cloud is running, consider:
|
||||
|
||||
- Setting up backups with [Velero](https://velero.io/)
|
||||
- Adding monitoring with Prometheus and Grafana
|
||||
- Deploying applications like Nextcloud, Home Assistant, or Gitea
|
||||
- Exploring the Kubernetes Dashboard to monitor your services
|
||||
|
||||
Welcome to your personal cloud journey! You now have the foundation for hosting your own services and taking control of your digital life.
|
||||
~/my-wild-cloud/README.md
|
||||
|
Reference in New Issue
Block a user