49 lines
1.2 KiB
Markdown
49 lines
1.2 KiB
Markdown
# Install
|
|
|
|
This directory is reserved for ordered, idempotent installation scripts for Atlas.
|
|
|
|
## What Belongs Here
|
|
|
|
- Bootstrap scripts.
|
|
- Package installation scripts.
|
|
- Service installation scripts.
|
|
- Storage, runtime, and tooling setup scripts.
|
|
- Validation wrappers for installation phases.
|
|
|
|
## What Must Not Be Stored Here
|
|
|
|
- Secrets, passwords, tokens, private keys, or live credentials.
|
|
- One-off experiments.
|
|
- Generated logs.
|
|
- Downloaded package caches.
|
|
- Application source code.
|
|
- Deployment artefacts.
|
|
|
|
## Naming Conventions
|
|
|
|
Use a two-digit numeric prefix followed by a short lower-case hyphenated name:
|
|
|
|
```text
|
|
01-base-tools.sh
|
|
02-dotnet.sh
|
|
03-sqlserver.sh
|
|
04-nginx.sh
|
|
05-docker.sh
|
|
```
|
|
|
|
Scripts must follow [SERVER-STANDARDS.md](../SERVER-STANDARDS.md).
|
|
|
|
## Expected Future Structure
|
|
|
|
Phase scripts may be added directly under this directory at first. If the directory grows, shared helpers may be added under a clearly named subdirectory.
|
|
|
|
Future structure is `TODO: Confirm during the relevant implementation phase.`
|
|
|
|
## Security Considerations
|
|
|
|
- Use `sudo` only for commands that need it.
|
|
- Do not print secrets.
|
|
- Do not embed credentials.
|
|
- Validate package sources and signing keys.
|
|
- Make scripts safe to rerun.
|