84 lines
1.9 KiB
Markdown
84 lines
1.9 KiB
Markdown
|
# Package Build Output
|
||
|
|
|
||
|
|
**Purpose**: Platform-specific packages (deb, rpm, tar.gz, etc.) created from distribution artifacts.
|
||
|
|
|
||
|
|
## Contents
|
||
|
|
|
||
|
|
This directory contains the output from package creation tools that convert distribution artifacts into system-specific formats.
|
||
|
|
|
||
|
|
## Package Formats
|
||
|
|
|
||
|
|
Generated packages may include:
|
||
|
|
|
||
|
|
### Linux Packages
|
||
|
|
|
||
|
|
- **deb** - Debian/Ubuntu packages
|
||
|
|
- **rpm** - RedHat/CentOS packages
|
||
|
|
- **tar.gz** - Portable tarball archives
|
||
|
|
- **AppImage** - Universal Linux application format
|
||
|
|
|
||
|
|
### macOS Packages
|
||
|
|
|
||
|
|
- **pkg** - macOS installer packages
|
||
|
|
- **dmg** - macOS disk image
|
||
|
|
- **tar.gz** - Portable archive
|
||
|
|
|
||
|
|
### Windows Packages
|
||
|
|
|
||
|
|
- **msi** - Windows installer
|
||
|
|
- **zip** - Portable archive
|
||
|
|
- **exe** - Self-extracting executable
|
||
|
|
|
||
|
|
### Container Images
|
||
|
|
|
||
|
|
- **docker** - Docker container images
|
||
|
|
- **oci** - OCI container format
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
This directory is generated by the package build system. Do not commit contents to git (configured in .gitignore).
|
||
|
|
|
||
|
|
Create packages:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
just package-all # All format packages
|
||
|
|
just package-linux # Linux packages only
|
||
|
|
just package-macos # macOS packages only
|
||
|
|
just package-deb # Debian package only
|
||
|
|
```
|
||
|
|
|
||
|
|
Install a package:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Linux
|
||
|
|
sudo dpkg -i provisioning-*.deb # Debian
|
||
|
|
sudo rpm -i provisioning-*.rpm # RedHat
|
||
|
|
|
||
|
|
# macOS
|
||
|
|
sudo installer -pkg provisioning-*.pkg -target /
|
||
|
|
```
|
||
|
|
|
||
|
|
## Package Verification
|
||
|
|
|
||
|
|
Verify package contents:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
dpkg -c provisioning-*.deb # List Debian package contents
|
||
|
|
rpm -ql provisioning-*.rpm # List RedHat package contents
|
||
|
|
tar -tzf provisioning-*.tar.gz # List tarball contents
|
||
|
|
```
|
||
|
|
|
||
|
|
## Cleanup
|
||
|
|
|
||
|
|
Remove all packages:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
just clean # Clean all build artifacts
|
||
|
|
```
|
||
|
|
|
||
|
|
## Related Directories
|
||
|
|
|
||
|
|
- `dist/` - Build artifacts that packages are created from
|
||
|
|
- `distribution/` - Distribution generation (uses package outputs)
|
||
|
|
- `release/` - Version management for packages
|