Once you’ve created your custom code and committed it to GitHub, you can now Build and Deploy it.
Accessing the Page
If you can’t access the Deployment page, it may need to be enabled:
- Contact Customer Care.
- Request to enable the Deployment page in Corporate Admin.
Important: Only enable the Deployment page when you have the Extension code ready to commit, or errors may occur.
Suppose the page is enabled and you still can’t access it. In that case, you may need the ViewAdministration() permission enabled for your Role by your Corporate Administrator.
Testing Code Before Deploying
Warning: You should always test your code on your Stage environment first. Attempting to Deploy any code with errors can break vital functionality.
- In GitHub, push your changes to Master.
- In your Stage environment (
corpadmin.directscalestage.com), navigate to the Deployment page.
- Queue a New Build. If your build fails, then there were errors in your code. See Failed Builds.
- Resolve any errors.
- When ready, you can Deploy to Live.
Building a New Artifact
On the Deployment page, you may see all your previous builds from GitHub.
Click Queue New Build to add a new build artifact. This queues the build across all environments (Stage/Live).
If your build fails, then there were errors in your code.
Click the Failed link to open a modal where you can view the errors. Each error indicates at which class and line number the error occurred.
Tip: If you refresh the page in the browser after the build fails, you’ll get an Extension Load Log that provides you more context to the errors.
Locate the errors in your code.
When committed and ready to go, you can return to the Deployment page and queue a new build.
Note: Many deployment errors on the Extension are caused by dependency registration. For example, suppose you register your Hooks/APIs in the wrong order, and one is dependent on another. In that case, the build will fail unless the dependent one is listed first.
Deploying to Live
Note: The Build only Deploys to the current environment. Log in to each environment and deploy manually.
Click Deploy. This queues the pipeline, and your new version is ready to use.
The currently deployed version is displayed at the top right of the page:
Old code is better than broken code, so if you’ve made a mistake, you can always roll back to an older version.
Important: Always deploy in your Stage environment first.
On the Deployment page:
- Use the table to locate the version to which you want to revert.
- Click Deploy.