DevCloud Legacy
Plugin for DevCloud platform integration
@bjb-forge/nx-devcloud-legacy-project
Installation
pnpm exec forge add @bjb-forge/nx-devcloud-legacy-projectPlugin Options
{
"plugin": "@bjb-forge/nx-devcloud-legacy-project/nx-plugin",
"options": {}
}| Option | Type | Description |
|---|---|---|
platform.program | string | Name of your platform program (only small letters and numbers) |
localPlugins | boolean | Whether you declare local Nx plugins in your repository (will trigger a 'tsc --build' before the build) |
ci.image | string | Image to be used for your CI runner. Defaults to forge images- use only after agreeing with TechX team. |
ci.verbose | boolean | Run the CI in verbose mode by setting NX_VERBOSE_LOGGING to true |
ci.cache | boolean | Whether to keep Nx cache or not |
ci.affected | boolean | Whether to only build affected projects (true) or all projects (false) |
ci.execution | string | Controls whether CI tasks run in parallel (single nx command with all targets) or in series (one nx command per target) |
ci.workers | number | Number of parallel workers to use for nx commands (adds --parallel=N) |
ci.unbuffer | boolean | Whether to unbuffer the output of CI commands |
ci.release | object | Release settings |
Configuration
Helm
Helm charts can opt out of versioning and publishing by adding a forge/release annotation to Chart.yaml. The key is flat (not nested under a forge map) because Helm requires Chart.yaml's annotations to be a map<string, string>:
annotations:
forge/release: 'false'When forge/release: 'false' is set, the chart is excluded from the release pipeline — its version will not be bumped and it will not be pushed to the chart registry.
Inferred Targets
nx-release-publish
Publishes the project artifact to a registry.
| Variant | Condition |
|---|---|
| Helm Chart | When Chart.yaml exists |
| Scotty Deploy | When release.json or nexus_rel.json exists |
deploy
Deploys the application using Scotty.
Condition: Scotty projects with .gitlab-cd.yml.tmpl template
sync
Synchronizes version information for Scotty deployments.
Condition: Scotty projects with release.json or nexus_rel.json
rollout-release
Creates a rollout release for the deployment pipeline.
Condition: Projects with releases.yaml
rollout-deploy
Deploys using Helmfile sync.
Condition: Projects with releases.yaml
rollout-undeploy
Destroys the rollout deployment.
Condition: Projects with releases.yaml
pre
Initializes the rollout workflow template.
Condition: Workspace root when releases.yaml exists
sync-gitlab-ci-yml
Synchronizes GitLab CI/CD pipeline configuration.
Condition: When .gitlab/workflows/.gitlab-ci.yml exists