All posts · VBCS Applications

VBCS Deployment: From Development to Production

The VBCS deployment pipeline is more complex than clicking Publish. Here's a reliable approach to versioning, environment promotion, and production go-live without surprises.

Anurag Jangra · February 8, 2026 · 6 min read · ... views

VBCS has a built-in deployment mechanism — click Stage, then Publish. This is fine for a personal project. For enterprise applications with multiple environments and ongoing releases, you need a structured approach.

Environment strategy

The standard Oracle Cloud environment progression: Development → Test/UAT → Production

Each environment has its own VBCS instance (or separate applications within the same instance). The key decisions:

  • Single VBCS instance with separate applications per environment, or separate OCI tenancies?
  • How are service connection endpoints promoted between environments?
  • Who has deployment authority for each environment?

For most enterprise deployments: separate applications within the same instance, with production deployment requiring an approver role separate from the developer.

Version management

VBCS uses a simple publish/stage model — it doesn’t have Git-based version control built in. Work around this:

  1. Name your versions descriptively — use the “Version” field in VBCS to tag each published version with a meaningful identifier (e.g. v1.2.3-po-workflow-fix)
  2. Export the application before major changes — VBCS export creates a ZIP you can store in Git as a binary backup
  3. Document what each publish contains — VBCS doesn’t have a changelog; maintain one externally (Confluence, Notion, a simple text file)

Service connection endpoint promotion

The trickiest part of VBCS deployment: service connections that point to development endpoints need to point to production endpoints in the production app.

VBCS doesn’t have environment variables — the most reliable approach is to maintain the endpoint URLs in OIC lookup tables, fetched by the VBCS app at startup. This way, the VBCS application code is identical across environments; only the lookup table values differ.

Staging vs Publishing

Stage deploys to a staging URL accessible for testing — real users cannot access it without direct link and specific permissions.

Publish replaces the live version — all users hit the new version immediately on next page load.

For significant releases: stage first, verify with business users, then publish. For patches: assess risk; minor bug fixes can go directly to publish if staging delay isn’t warranted.

Rollback

VBCS’s Previous Version feature lets you revert to the prior published version. Keep this in mind — don’t publish until you have a stable baseline to roll back to.

Think Beyond the Implementation

Questions worth sitting with after reading this

01

Why is this architecture appropriate for this specific context — and where would it be the wrong choice?

02

What assumptions did we make that aren't stated explicitly? What happens if those assumptions are wrong?

03

What would break first if the requirements changed — volume doubled, a third system was added, or the deadline halved?

04

What alternatives did we reject, and why? Was the decision made on evidence — or habit?

AJ
Anurag Jangra
Oracle Cloud PaaS Consultant · OIC & VBCS Specialist

4.5+ years delivering enterprise Oracle Cloud integrations and VBCS applications across manufacturing, IT services, and financial sectors. OCI Certified — writes about real-world OIC, VBCS, SQL, and BI Publisher patterns from production experience.

Chat on WhatsApp