Skip to content

Commit 3536a6f

Browse files
committed
docs: rebrand from Genesis Core to Exordos Core
- Rename CLI commands from 'genesis' to 'exordos' - Update configuration files from 'genesis.yaml' to 'exordos.yaml' - Change repository URLs from 'repository.genesis-core.tech' to 'repository.exordos.com' - Update element paths from 'genesis-elements' to 'exordos-elements' - Rename client credentials from 'GenesisCore' to 'ExordosCore' - Update build profiles from 'genesis_base' to 'exordos_base' - Change systemd service prefix from 'exo_srv' to 'ec' - Update domain references from 'genesis-core.tech' to 'exordos.com' - Rename GitHub repository references from 'genesis_basic' to 'exordos_basic' - Update devtools reference from 'genesis_devtools' to 'exordos_devtools' - Use full command names (e.g., 'exordos elements install' instead of 'exordos e install') Updated 24 documentation files across docs/ directory.
1 parent ca0e238 commit 3536a6f

24 files changed

Lines changed: 204 additions & 204 deletions

docs/app-developer-guide/build.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,32 @@
11
---
2-
title: genesis build
2+
title: exordos build
33
---
44

55
## Overview
66

7-
`genesis build` **compiles and packages** your Exordos element into distributable artifacts — images, manifests, and any other resources required for deployment.
7+
`exordos build` **compiles and packages** your Exordos element into distributable artifacts — images, manifests, and any other resources required for deployment.
88

9-
The command reads the **`genesis/genesis.yaml`** file — the main configuration file that transforms your application into a platform element. This file contains the `build` section describing:
9+
The command reads the **`exordos/exordos.yaml`** file — the main configuration file that transforms your application into a platform element. This file contains the `build` section describing:
1010

1111
- **Dependencies** — files, directories or external binary artifacts required for the build
1212
- **Elements** — a single project can produce multiple elements on output (e.g., separate API and worker services)
1313
- **Artifacts** — images, binaries, or other build outputs
1414

1515
Running the command performs the following steps:
1616

17-
1. **Resolve dependencies** — fetches dependencies specified in `genesis.yaml`.
17+
1. **Resolve dependencies** — fetches dependencies specified in `exordos.yaml`.
1818
2. **Process manifests** — renders manifest files (supporting raw YAML or Jinja2 templates with built-in variables).
19-
3. **Build artifacts** — creates images and other build outputs based on the `build` section in `genesis.yaml`.
19+
3. **Build artifacts** — creates images and other build outputs based on the `build` section in `exordos.yaml`.
2020

2121
```bash
22-
genesis build [OPTIONS] PROJECT_DIR
22+
exordos build [OPTIONS] PROJECT_DIR
2323
```
2424

2525
Key options:
2626

2727
| Option | Description |
2828
|---|---|
29-
| `-c, --genesis-cfg-file TEXT` | Name of the project configuration file (default: `genesis.yaml`) |
29+
| `-c, --exordos-cfg-file TEXT` | Name of the project configuration file (default: `exordos.yaml`) |
3030
| `--build-dir TEXT` | Directory for temporary build artifacts |
3131
| `--output-dir TEXT` | Directory where final artifacts are stored |
3232
| `--deps-dir TEXT` | Directory where dependencies are fetched |
@@ -69,48 +69,48 @@ You may need to relogin to apply the changes. Now you are ready to build your el
6969
From your project directory:
7070

7171
```bash
72-
genesis build .
72+
exordos build .
7373
```
7474

7575
### Rebuild with Force
7676

7777
If you need to rebuild even when artifacts already exist:
7878

7979
```bash
80-
genesis build --force .
80+
exordos build --force .
8181
```
8282

8383
### Build with Custom Variables
8484

8585
Pass additional variables to manifest templates:
8686

8787
```bash
88-
genesis build --manifest-var commit_hash=$(git rev-parse --short HEAD) .
88+
exordos build --manifest-var commit_hash=$(git rev-parse --short HEAD) .
8989
```
9090

9191
### Inventory Build
9292

9393
For advanced deployments, build using the inventory format:
9494

9595
```bash
96-
genesis build --inventory .
96+
exordos build --inventory .
9797
```
9898

9999
---
100100

101101
## Build Process
102102

103-
The build process creates **VM disk images** that run on the Exordos Core platform. Packer starts a virtual machine from a base OS image, copies all resolved dependencies into it, and executes the provisioning script specified in `genesis.yaml`. This script is typically a Bash script that installs packages, configures services, and prepares the image. Once provisioning completes, the VM shuts down and the resulting disk image is packaged for deployment. This process is configured through the `elements` section in `genesis.yaml` where you define the base profile, provisioning script, output format, and any build overrides.
103+
The build process creates **VM disk images** that run on the Exordos Core platform. Packer starts a virtual machine from a base OS image, copies all resolved dependencies into it, and executes the provisioning script specified in `exordos.yaml`. This script is typically a Bash script that installs packages, configures services, and prepares the image. Once provisioning completes, the VM shuts down and the resulting disk image is packaged for deployment. This process is configured through the `elements` section in `exordos.yaml` where you define the base profile, provisioning script, output format, and any build overrides.
104104

105105
---
106106

107107
### Dependencies Resolution
108108

109-
Before building, `genesis build` resolves all dependencies declared in the `build.deps` section of `genesis.yaml`. Each dependency specifies a destination path (`dst`) and a source. Dependencies can be local directories, remote artifacts, or optional development resources.
109+
Before building, `exordos build` resolves all dependencies declared in the `build.deps` section of `exordos.yaml`. Each dependency specifies a destination path (`dst`) and a source. Dependencies can be local directories, remote artifacts, or optional development resources.
110110

111111
#### Local Project Directory
112112

113-
Include another local project or directory into your build. The source path is relative to the `genesis.yaml` file location.
113+
Include another local project or directory into your build. The source path is relative to the `exordos.yaml` file location.
114114

115115
```yaml
116116
deps:
@@ -134,7 +134,7 @@ Fetch remote resources via HTTP/HTTPS. This is useful for kernel images, boot lo
134134
deps:
135135
- dst: /opt/exordos_core/artifacts/vmlinuz
136136
http:
137-
src: https://repository.genesis-core.tech/seed_os/1.1.0/vmlinuz
137+
src: https://repository.exordos.com/seed_os/1.1.0/vmlinuz
138138
```
139139

140140
The `vmlinuz` kernel image is downloaded and placed at the specified destination path before the build continues.
@@ -157,28 +157,28 @@ Here, the SDK is only included if the `LOCAL_GENESIS_SDK_PATH` environment varia
157157

158158
### VM Image Build Configuration
159159

160-
Each element in the `elements` list of `genesis.yaml` defines how its VM images are built. An element can produce multiple images (for example, different formats or variants). The following parameters control the image creation process:
160+
Each element in the `elements` list of `exordos.yaml` defines how its VM images are built. An element can produce multiple images (for example, different formats or variants). The following parameters control the image creation process:
161161

162162
| Parameter | Description |
163163
|---|---|
164164
| `name` | The name of the output image. Used to identify the image in the build output and registry. |
165165
| `format` | Disk image format. Supported formats: `raw`, `qcow2`, `gz`. The `gz` format is a compressed `raw` image. Can also reference an environment variable like `GEN_IMG_FORMAT_CORE=qcow2`. |
166-
| `profile` | Base OS image profile to use as the starting point (e.g., `genesis_base`). This determines the initial operating system and pre-installed packages. |
166+
| `profile` | Base OS image profile to use as the starting point (e.g., `exordos_base`). This determines the initial operating system and pre-installed packages. |
167167
| `script` | Path to the provisioning script executed inside the VM. This script performs all application-specific setup: installing dependencies, copying files, configuring services. |
168-
| `override` | Build-time parameter overrides passed to the underlying tool (e.g., Packer). Common uses include increasing `disk_size`, `cpus`, or `memory` for the build VM. When using the `genesis_custom` profile, specify `base_image_url` and `base_image_checksum` here to use any custom image as the base. |
168+
| `override` | Build-time parameter overrides passed to the underlying tool (e.g., Packer). Common uses include increasing `disk_size`, `cpus`, or `memory` for the build VM. When using the `exordos_custom` profile, specify `base_image_url` and `base_image_checksum` here to use any custom image as the base. |
169169
| `envs` | List of environment variables to pass into the build process. These become available to the provisioning script and build tools. |
170170

171171
#### Using Environment Variables
172172

173-
Define variables in `genesis.yaml`:
173+
Define variables in `exordos.yaml`:
174174

175175
```yaml
176176
elements:
177177
- manifest: manifests/core.yaml.j2
178178
images:
179179
- name: my-app
180180
format: qcow2
181-
profile: genesis_base
181+
profile: exordos_base
182182
script: install.sh
183183
envs:
184184
- APP_PORT=8080
@@ -220,7 +220,7 @@ For Jinja2 templates, the following variables are available by default:
220220
Additional variables can be passed using `--manifest-var key=value`:
221221

222222
```bash
223-
genesis build --manifest-var environment=production --manifest-var region=europe-east .
223+
exordos build --manifest-var environment=production --manifest-var region=europe-east .
224224
```
225225

226226
[Full manifest reference →](../misc/manifests.md)
@@ -252,16 +252,16 @@ The `inventory.json` file provides a complete index of the build output, mapping
252252
| `configs` | Configuration files (if any) |
253253
| `templates` | Template files used during build (if any) |
254254

255-
The exact contents depend on your project type and `genesis.yaml` configuration.
255+
The exact contents depend on your project type and `exordos.yaml` configuration.
256256

257257
---
258258

259259
## Next Steps
260260

261261
After a successful build, your elements are ready for:
262262

263-
- [`genesis push`](push.md) — publish to the ecosystem registry
264-
- [`genesis deploy`](deploy.md) — deploy to a Exordos installation
263+
- [`exordos push`](push.md) — publish to the ecosystem registry
264+
- [`exordos deploy`](deploy.md) — deploy to a Exordos installation
265265

266266
---
267267

0 commit comments

Comments
 (0)