Update docs for adding apps.

This commit is contained in:
2025-10-22 22:36:53 +00:00
parent 458e70b7be
commit 351f58b80d
4 changed files with 97 additions and 28 deletions

View File

@@ -23,7 +23,7 @@ Configuration files use **gomplate templating** to reference operator configurat
- Use `{{ .operator.email }}` for operator email
- All template variables must be defined in either the app's `manifest.yaml` under `defaultConfig` or be standard Wild Cloud operator variables
Templates are compiled by `wild-app-add` when operators add apps to their Wild Cloud home directory.
Templates are compiled when users add apps to their Wild Cloud instance via the web app, CLI, or API.
### Label Strategy
@@ -132,13 +132,27 @@ Then:
5. Add standard Wild Cloud labels to `kustomization.yaml`
6. Add security contexts to all pods
## Common Wild Cloud Commands
## Managing Wild Cloud Apps
These commands are run by operators from their Wild Cloud home directory (not this repository):
Users can manage apps through:
- `wild-apps-list` - List all available apps
- `wild-app-add <app-name>` - Add an app (compiles templates, updates config/secrets)
- `wild-app-deploy <app-name>` - Deploy an app to the cluster
1. **Web App**: Navigate to the Apps page in your instance to browse, add, configure, and deploy apps
2. **CLI**: Use the Wild CLI for terminal-based workflows:
- `wild app list` - List all available apps
- `wild app add <app-name>` - Add an app (compiles templates, updates config/secrets)
- `wild app deploy <app-name>` - Deploy an app to the cluster
- `wild app list-deployed` - List deployed apps
- `wild app status <app-name>` - Get app status
- `wild app delete <app-name>` - Delete an app
3. **API**: Use the Wild Central API endpoints for automation:
- `GET /api/v1/apps/available` - List all available apps
- `GET /api/v1/apps/available/{app-name}` - Get app details
- `POST /api/v1/instances/{instance-name}/apps` - Add an app (compiles templates, updates config/secrets)
- `POST /api/v1/instances/{instance-name}/apps/{app-name}/deploy` - Deploy an app to the cluster
- `GET /api/v1/instances/{instance-name}/apps` - List deployed apps
- `GET /api/v1/instances/{instance-name}/apps/{app-name}/status` - Get app status
## Validation