torrust-tracker-deployer 0.1.0

Torrust Tracker Deployer - Deployment Infrastructure with Ansible and OpenTofu
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

# Setup Scripts - MIGRATION NOTICE

**⚠️ This directory has been migrated to the Rust-based dependency installer.**

## Migration Notice

The bash installation scripts (`install-opentofu.sh`, `install-ansible.sh`, `install-lxd-ci.sh`) have been **removed** and replaced with the Rust-based `dependency-installer` binary.

### New Installation Method

For dependency installation, use the `dependency-installer` binary:

```bash
# Install all dependencies
cargo run -p torrust-tracker-deployer-dependency-installer --bin dependency-installer -- install

# Check which dependencies are installed
cargo run -p torrust-tracker-deployer-dependency-installer --bin dependency-installer -- check

# List all available dependencies
cargo run -p torrust-tracker-deployer-dependency-installer --bin dependency-installer -- list

# Install specific dependency
cargo run -p torrust-tracker-deployer-dependency-installer --bin dependency-installer -- install --dependency opentofu

# See all options
cargo run -p torrust-tracker-deployer-dependency-installer --bin dependency-installer -- --help
```

### Benefits of the New Approach

- **Type-safe**: Rust's type system catches errors at compile time
- **Better error handling**: Clear, actionable error messages
- **Consistent logging**: Structured logging via `tracing` crate
- **Testable**: Unit and integration tests ensure reliability
- **Maintainable**: Single codebase for all dependency management
- **Cross-platform ready**: Foundation for supporting multiple platforms

### Supported Dependencies

The dependency installer supports:

- **cargo-machete** - Detects unused Rust dependencies
- **OpenTofu** - Infrastructure provisioning tool (Terraform alternative)
- **Ansible** - Configuration management and automation platform
- **LXD** - Lightweight VM manager for container-based testing

### Documentation

For complete documentation on the dependency installer, see:

- **Package README**: [packages/dependency-installer/README.md](../../packages/dependency-installer/README.md)
- **LXD Setup**: [templates/tofu/lxd/README.md](../../templates/tofu/lxd/README.md)
- **LXD Tech Stack**: [docs/tech-stack/lxd.md](../../docs/tech-stack/lxd.md)

### CI/CD Integration

GitHub Actions workflows now use the dependency installer:

- **`.github/workflows/test-e2e-provision.yml`** - E2E provision and destroy tests
- **`.github/workflows/test-e2e-config.yml`** - E2E configuration tests
- **`.github/workflows/test-lxd-provision.yml`** - LXD provisioning tests

Example workflow step:

```yaml
- name: Install dependencies
  run: |
    cargo build -p torrust-tracker-deployer-dependency-installer --bin dependency-installer
    cargo run -p torrust-tracker-deployer-dependency-installer --bin dependency-installer -- install
```

### Local Development

For local development, the dependency installer automatically handles:

- **CI Detection**: Automatically applies CI-specific configurations when needed
- **Permissions**: Proper handling of LXD socket permissions
- **Group Membership**: Sets up appropriate user groups

**Important**: For local LXD development, follow the proper group membership approach documented in the tech stack guides.

### Troubleshooting

If you encounter issues with the dependency installer:

1. **Check installation status**: `cargo run -p torrust-tracker-deployer-dependency-installer --bin dependency-installer -- check`
2. **Enable debug logging**: Add `--verbose` flag or `--log-level debug`
3. **View available dependencies**: `cargo run -p torrust-tracker-deployer-dependency-installer --bin dependency-installer -- list`
4. **Check exit codes**: Exit code 0 = success, non-zero = failure

For detailed troubleshooting, see the [dependency installer README](../../packages/dependency-installer/README.md).

### Migration Timeline

- **Created**: Issue #113 (Create Dependency Installation Package)
- **Migrated**: Issue #119 (Update CI Workflows and Remove Bash Scripts)
- **Removed bash scripts**: November 2025

This directory is preserved for documentation purposes and may be removed in future versions.