nyl 0.4.0

Kubernetes manifest generator with Helm integration
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# generate

Generate auxiliary resources and configurations from Nyl manifests.

## Usage

```bash
nyl generate <subcommand> [options]
```

## Subcommands

### argocd

Generate ArgoCD Application manifests from Nyl releases.

```bash
nyl generate argocd [OPTIONS] <PATH>
```

**Arguments:**
- `<PATH>`: Directory to scan for Nyl release files

**Options:**
- `-o, --output <FILE>`: Output file (default: stdout)
- `--repo-url <URL>`: Git repository URL for generated Applications
- `--target-revision <REV>`: Target revision (branch/tag/commit)
- `--destination-server <URL>`: Kubernetes server URL (default: https://kubernetes.default.svc)
- `--destination-namespace <NS>`: Namespace for Applications (default: argocd)
- `--project <PROJECT>`: ArgoCD project name (default: default)

**Example:**

```bash
# Generate Applications for all releases in clusters/default
nyl generate argocd clusters/default \
  --repo-url https://github.com/myorg/gitops.git \
  --target-revision main \
  -o applications.yaml
```

### schema config

Generate JSON Schema for `nyl.toml` to stdout.

```bash
nyl generate schema config
```

## Relation to ApplicationGenerator

The `nyl generate argocd` command is a **manual CLI tool** for one-time generation of ArgoCD Applications from a directory of Nyl releases. It's useful for:

- Initial ArgoCD bootstrap
- One-off Application generation
- CI/CD pipelines that don't use ApplicationGenerator

The **ApplicationGenerator resource** is the **recommended approach** for ongoing management. It provides:

- Automatic discovery and generation during `nyl render`
- Integration with ArgoCD plugin for GitOps
- Declarative configuration
- Self-hosting bootstrap pattern

**When to use each:**

| Use Case | Tool | Why |
|----------|------|-----|
| Bootstrap ArgoCD | ApplicationGenerator | Declarative, self-hosting |
| Ongoing management | ApplicationGenerator | Automatic, GitOps-native |
| One-time bootstrap | `nyl generate argocd` | Manual control |
| CI/CD generation | `nyl generate argocd` | Explicit generation step |

**Recommendation**: Use ApplicationGenerator for most use cases. It's processed during `nyl render` and integrates seamlessly with ArgoCD.

## See Also

- [ApplicationGenerator Resource](../argocd/application-generator.md)
- [ArgoCD Bootstrapping](../argocd/bootstrapping.md)
- [render Command](./render.md)