Onboarding guide
The Harness Platform and modules are built to help developers and DevOps teams deliver software with the highest velocity, quality, security, reliability, and resilience, while achieving the lowest cost possible and remaining inside the governance guardrails necessary for meeting organizational goals.
Follow this guide to get started with the Harness Platform.
Access your Harness account
Harness offers both SaaS and on-premises editions.
- SaaS
- Self-Managed Enterprise Edition
Harness SaaS is a fully-managed cloud version of the Harness Platform. Harness offers free, team, and enterprise plan tiers. For more information about plan options and pricing, go to Subscriptions and licenses.
Harness offers a free tier of the Harness Software Delivery Platform to help you on your software delivery journey.
To create an account on the free plan, sign up for a free account and then sign in to your Harness account.
New accounts on the team or enterprise plan must receive an invitation email from an Account Administrator to be able to sign in. Contact Harness Support if you need more information or if you do not know your Account Administrator.
Harness Self-Managed Enterprise Edition (aka SMP) is a self-managed, Kubernetes-native version of Harness Platform that runs on your own public or private cloud infrastructure.
This option requires access to a Harness SMP license key as well as the ability to download the Harness SMP software (container images & Helm Chart). Contact Harness Support if you do not have access to either the license key or the download location for your SMP account.
When you have the license key and download location, install and configure a Harness SMP instance as explained in Install Harness SMP using Helm Chart.
Then create your Harness SMP Account. After initial account creation, you can sign in to your Harness SMP account by navigating to http://YOUR_DOMAIN_NAME/auth/#/signin
.
Review key concepts
Get familiar with terminology and functionality found in the Harness Platform and Harness modules.
Create projects and invite collaborators
To begin, create a project and invite a few collaborators. Harness recommends creating a sample project with a few pilot users to get familiar with the Harness Platform.
Once you're familiar with the mechanics, you can create more organizations and projects or represent your business units and product development initiatives.
Manage users
Learn about authentication and RBAC to understand how to manage users in your Harness Account.
You can configure broad or highly-granular permissions structures.
You can also automate provisioning of users from external sources, along with their user group memberships and role assignments:
- Provision users and groups with Okta (SCIM)
- Provision users and groups using Microsoft Entra ID (SCIM)
- Provision users and groups with OneLogin (SCIM)
- Just-in-time user provisioning
Configure shared resources
Shared resources in Harness include delegates, connectors, secrets, and more. You'll use these resources with practically everything you do in Harness.
You can configure these at the account, organization, or project scope depending on how broadly you want to share them.
Shared resources tutorials
- Add a secret manager
- Install delegate on Kubernetes or Docker
- Build and set up a delegate with a minimal image type
- Install Harness Delegate on Google Kubernetes Engine (GKE) With Workload Identity
Automate setup of shared resources
Shared resources created at the account scope are shared with all organizations and projects in your account.
Harness recommends you use the Harness Terraform Provider or the Harness REST API to automate configuration of these shard resources.
- Terraform Provider
- Harness API
You can achieve a high degree of automation and repeatability in deploying and managing resources on Harness by integrating the Harness Terraform Provider into your Harness onboarding workflows.
Use the following documentation and Harness Terraform Registry to the Install the Harness Terraform Provider and set up Terraform configuration:
A sample Terraform deployment repo is available for your use.
For the best results, follow best practices for Terraform and CI/CD, such as:
- Source control: Save your Terraform configurations in a version control system like Git. This helps in tracking changes and enables collaboration.
- Automate plan and apply: Implement CI/CD tools to automate the
terraform plan
andterraform apply
steps. Popular choices include using Harness CD Pipelines to automate and onboard services. - State management: Use remote state storage solutions, such as Terraform Cloud or AWS S3 with state locking, to ensure that your state is consistent across various environments or teams.
- Notifications: Implement notifications for Terraform actions. If something goes wrong during
terraform apply
, it can be beneficial to have notifications sent to Slack, Email, etc. - Monitoring and Logging: Monitor your infrastructure with tools like Grafana or Prometheus. Logging changes and activities help in audit trails.
- Secrets management: Use tools like HashiCorp Vault or AWS Secrets Manager to securely store sensitive information like API keys.
- Backup: Regularly back up your Terraform state files to prevent data loss.
- Documentation: Maintain a well-documented record of all Terraform scripts and modules. Documenting the design decisions and usage instructions ensures that any team member can understand and use the automation built around the Terraform provider.
Go to Get started with Harness API.
Dive into modules
After onboarding to the Harness Platform, you're ready to start using Harness modules to supercharge your SDLC.
Explore module documentation to get started with Harness modules and start building CI/CD pipelines.
The Harness Platform has several cross-module features that can optimize and enhance your pipelines and module usage, including:
- Harness AIDA
- Variables, expressions, and runtime input
- Templates
- Triggers
- Notifications
- Approvals
- Governance and monitored services
- Dashboards
- Global default settings
Become a Harness Certified Expert
Explore the Harness University to find instructor-led training opportunities and test your skills in module certification courses.