Hello, World!

Many coding tutorials start with showing how to print "Hello World" on a computer screen as it's one of the simplest things you can do in any programming language. We're going to follow that tradition and learn how to get started on Bluuberry by creating a simple Hello_World__c text field in a Salesforce Sandbox and later deploying it to a Salesforce Test environment.

You’ll learn how to:

  • Connect environments
  • Create a project
  • Create and complete a merge request
  • Create a release
  • Deploy a release

What is Bluuberry?

Bluuberry is a Continuous Integration and Continuous Delivery platform for Salesforce with its own Version Control System that makes things really easy for you, as you'll soon find out. Bluuberry lets your team collaborate on your Salesforce projects, automate your release process, and reduce your release cycle time.

No DevOps or programming knowledge necessary

To complete this tutorial, you need a Bluuberry.com account, Internet access, Admin access in two Salesforce sandboxes (one for development work, and one for testing), and Admin access in Salesforce Production environment (don't worry we are not going to deploy anything to Production). There is no need to install anything.

Step 1. Create a Connected App

A Connected App is used to connect your environments to Bluuberry. Bluuberry uses OAuth 2.0 for secure delegated access to your Salesforce environments.

To create the Connected App, go to the Environments tab in Bluuberry and select Settings. Click on the Configure Connected App button and follow the steps outlined on the page.

Step 2: Connect your Source environment

Source environment is where you'll be making changes that are intended to be deployed to Production. Because you're working in a sandbox, breaking things is not really a problem. It's a great way to prototype your solutions and experiment.

To connect your Source environment to Bluuberry, go to the Environments tab in Bluuberry and select Connect Source Environment. A pop-up window will appear asking you to authorise the environment. Go ahead and authorize the environment.

Step 3: Connect your Test environment

Test environment is how you can ensure that your changes work correctly and are ready for deployment to Production. Asking your end-users to have a final look at the release in a Test environment before deploying it to Production is a great way to get early feedback, prevent rework and deliver features that the end-users actually want.

To connect your Test environment to Bluuberry, go to the Environments tab in Bluuberry and select Connect Test Environment. A pop-up window will appear asking you to authorise the environment. Go ahead and authorize the environment.

Step 4: Connect your Production environment (optional)

Finally, we will connect your Production environment but we won't be deploying anything to your Production environment in this tutorial. So, you can skip this step if you wish.

To connect your Production environment to Bluuberry, go to the Environments tab in Bluuberry and select Connect Production. A pop-up window will appear asking you to authorise the environment. Go ahead and authorize the environment.

Step 5: Create a project

A project in Bluuberry is a place for all your Salesforce user stories, changes and discussions.

To create a new project, go to the Projects tab in Bluuberry and click New project. Name your project Hello World and add a short description.

Step 6: Make a change in the Source environment

Log into your Source environment, go to Settings, pick an object and create a test field. Let's name the field Hello World.

Bluuberry will sync your changes within a minute. You don't need to do anything.

Step 7: Create a Merge request

Now, go to the Changes tab in Bluuberry. You should see the Hello World field and all of its dependencies, including its permissions, on the page. Select the field and its permissions and click Create merge request.

Step 8: Complete your Merge request

After you create the merge request, Bluuberry automatically validates your changes in your Test environment. Bluuberry automatically checks that your changes are deployable and that you didn't miss any dependencies.

Just wait for the tests to finish and after the validation is done, you should see the Success status on the merge request page. Click the Complete button to merge your changes and create a new release.

Step 9: Deploy your changes to Test environment

Now go to the Releases tab in Bluuberry. You should see the new release you have just created at the very top of the page.

Click on the release and then select the Test environment in the list on the bottom. That should bring you to the deployment detail page for the Test environment. Note that the deployment status is Pending. Click on the Deploy button in order to start the deployment to this environment.

Once the deployment succeeds, just log into your Test environment, and check that the field has been correctly deployed.

Congratulations!

By completing the steps above you've learned how to create a merge request and deploy a release on Bluuberry!

In this short tutorial you've learned all these things:

  • Connect Salesforce environments
  • Create a project
  • Create and complete a merge request
  • Create a release
  • Deploy a release

Great work! 👏