Instances
Information about Sourcegraph’s different instances.
- sourcegraph.com (or ‘DotCom’) is our public, free-to-use deployment.
- k8s.sgdev.org is a dogfood deployment that replicates the scale of our largest on-prem customers. This deployment also contains all of our private code.
- Managed instances are deployments of Sourcegraph we manage for customers.
- demo.sourcegraph.com is a managed instance used for CE demos.
- devmanaged.sourcegraph.com is a managed instance used for managed instances development.
- sourcegraph.sourcegraph.com is a managed instance used for Sourcegraph’s dogfooding needs. Informally referred to as “S2”. This instance is jointly owned by #dev-experience and #cloud. We continously deploy the latest unreleased version of Sourcegraph every one hour on weekdays, and you may also force rolling out a new deployent by clicking the
run workflowbutton.
For deployments of Sourcegraph we manage for customers, see managed instances.
Also see playbooks for common actions related to operating our Sourcegraph deployments.
DotCom
This deployment is also colloquially referred to as ‘DotCom’ and ‘sourcegraph.com’. It is the public deployment available to the public at sourcegraph.com/search.
sourcegraph.com deploys the latest changes from sourcegraph/sourcegraph on a daily basis.
This deployment also includes our documentation and about sites.
🐶 For dogfooding changes, use k8s.sgdev.org instead, which generally receives updates faster.
- DotCom cluster on GCP
gcloud container clusters get-credentials cloud --zone us-central1-f --project sourcegraph-dev - Kubernetes configuration
- Infrastructure configuration
- Alerts: #alerts-cloud and OpsGenie
- Playbooks
k8s.sgdev.org
NO LONGER PRIMARY DOGFOODING INSTANCE, SEE S2 BELOW
This deployment is also colloquially referred to as “dogfood”, “dogfood-k8s”, or just “k8s”. This is the Sourcegraph instance to use for dogfooding changes to Sourcegraph. It contains Sourcegraph private code, and deploys the latest Sourcegraph images via ArgoCD
We are following GitOps practice to handle deployment of k8s. The source of truth of the deployment is sourcegraph/deploy-sourcegraph-dogfood-k8s.
We use two scheduled GitHub Actions to continuously create PRs to update the images and merge the created PRs on a fixed schedule. If you would like to bypass the schedule, do the following
- Run https://github.com/sourcegraph/deploy-sourcegraph-dogfood-k8s/actions/workflows/update-tags.yml and wait for completion
- Run https://github.com/sourcegraph/deploy-sourcegraph-dogfood-k8s/actions/workflows/merge-pr.yml
- Your changes should be up in no time, or you may monitor the rollout status in <argocd.sgdev.org>
Learn more in deployment basics.
🚨 This deployment contains private code - for demos, use demo.sourcegraph.com instead.
- dogfood cluster on GCP
gcloud container clusters get-credentials dogfood --zone us-central1-f --project sourcegraph-dogfood - Kubernetes configuration
- Infrastructure configuration
- Alerts: #alerts-dogfood-k8s
- Playbooks
Managed instances
Managed instances are deployments of Sourcegraph we manage for customers. We also maintain some internal managed instances for various use cases.
sourcegraph.sourcegraph.com (S2)
This deployment is also colloquially referred to as “dogfood S2”, or just “S2”, it was spun up as a response to our change in product direction and becoming Cloud (managed instances) first. We use S2 as our primary dogfooding instance now, and feedback gets shared in #feedback-dogfood.
S2 gets deployed every hour between 8am and 10pm UTC on weekdays using a GitHub Actions workflow that updates the images, creates the PR, and merge the changes. The instance contains Sourcegraph private code, and deploys the latest Sourcegraph images.
demo.sourcegraph.com
This deployment is used by Sourcegraph CE for demos.
devmanaged.sourcegraph.com
This deployment is a managed instance used by Distribution for experimenting with managed instances in general.