Copado Base Setup and Implementation
Getting ready to implement Copado? This article lists several items that you need to take care of when rolling out Copado in your organization.
Users and Licenses
In this section we will go over the licenses and user permission sets required to start working with Copado:
- The first thing you need in order to start using Copado are Salesforce licenses for the users that will be using Copado. You can find all the information about the required Salesforce licenses in the article What Salesforce Licenses or Permissions Do I Need to Start Using Copado?
- Once you have the required Salesforce licenses, follow the steps below to assign Copado licenses and permissions to users and complete the Copado setup:
Each user needs to create an org credential for the org where Copado is installed. Otherwise, they won’t be able to use Copado properly.
- Sign up or log in to the Success community and install Copado.
- Navigate to the Account Summary page and click on Register Application to complete the registration with the Copado server.
- Create an org credential for each of the users that will be working with Copado in the org where Copado is installed.
- Create an API Key in order to enable the webhooks functionality, e.g. scheduling Copado jobs or allowing for custom automation of actions.
- If required, set up the sandbox environments that you will connect to Copado (sandboxes, developer, production orgs, e.g. dev1, dev2, int, UAT, etc) and then create org credentials for each of the orgs. To authenticate the org credential, sign in to each org with the corresponding user.
- If you want to provide your developers with a more restrictive access to Copado, create a permission set that grants Copado access to the users that will work with Copado:
- The Copado package provides the Copado User permission set with access to all Copado functionality. You can clone this permission set and customize it for other types of users (e.g. developers, QA, scrum master).
- If you have IP restrictions in your Salesforce org, make sure you whitelist the Copado static IP addresses in Setup > Security > Network Access.
Best Practices and Additional Configuration
Once you have successfully installed Copado and have all the required licenses and permissions to start working with Copado, it is recommended that you define a release process and then make the necessary changes to align Copado with your process.
Here are the suggested steps:
- Outline the steps you would like to follow starting when user stories are created and defined until they are released and move to upper environments:
- Get a graphical overview of the steps.
- Decide if admins and developers should submit their user stories for approval.
- Define which Copado quality gates you would like to enforce at the beginning. Quality gates include running Apex tests, static code analysis, pull request reviews, compliance scans and Selenium testing.
- If your process includes review quality gates (e.g. business testing, peer review, documentation review, etc.) consider creating custom fields, validation rules and process builder flows to enforce those quality gates.
- Consider modifying the main layouts your users will be working with (e.g. user story, project, epic, sprint) and add or remove fields as required. Having a defined process will help you focus on what you need to modify.
- Leverage Copado Academy and organize training sessions for your users to get hands-on learning about Copado. Contact your customer success manager for more information about Copado Academy.
- Review the documentation and configure a list of useful articles your users can go through to learn how to accomplish the most frequent tasks they will be working on. Share this list with the team so that they can access it whenever needed.
Developer and admin tasks usually include the following:
- Selecting or committing metadata components to a user story.
- Validating the user story deployment.
- Deploying a user story or submitting it for approval.
As each implementation of Copado is dependent on individual client requirements, a Copado expert can guide you and your team with a tailored implementation and best practices on release management for Salesforce. For more information, contact your customer success manager.