Cloud Trial Managed Instances
Trial Managed Instances (aka PoC) are private, dedicated Sourcegraph instances provisioned and managed by Sourcegraph - more. The purpose is to provide free of charge Managed Instances for future customers for a trial period (default is 30 days).
All processes are the same as for paid Managed Instances (for paying customers):
Difference from paid instances
The difference from paid Managed Instances:
- During the trial period, Sourcegraph is covering all the infrastructure and licence costs.
- Trial Managed Instances have the GCP label
instance-type=trial
, which allows to filter them. - Trial Managed Instances are monitored for trial expiration period (default 30 days). When a Trial Managed Instance expires, the instance requestor has to decide to:
Cloud Trial Requests from signup.sourcegraph.com
Due to the high costs of infrastructure & human resources, along with the low activation rates in the self-service cloud trial experiment, we are no longer automatically provisioning cloud trial instances. Effective February 1, 2023, SDRs are responsible for the initial follow up and qualification for cloud trial requests. SDRs should seek to schedule an introduction meeting between the prospective Sourcegraph cloud customer and the Sourcegraph account team (appropriate AE & CE) to qualify the technical and security requirements. If, following that conversation, there is mutual fit for a Sourcegraph cloud trial, CEs are responsible for requesting the trial via the workflow documented below:
- Prospect fills out web form requesting trial at signup.sourcegraph.com.
- Request is captured, and lead is generated and tagged with appropriate campaign info (PR - Trial - Cloud - 9.27.22).
- If lead is from AE-owned/named account, lead is routed to the Outbound SDR owner of that account.
- If lead is from unnamed account, lead is routed to Inbound SDR.
- SDR lead owner follows up with lead to qualify interest and schedule introductory call with appropriate AE & CE.
- If it is determined that a trial managed instance is appropriate for the prospect, the CE requests a trial via the Trial Managed Instance Issue Template
New Trial Managed Instance create SLA (since 27th of September 2022)
Architecture
Trial Managed Instances sizes
Trial managed instances default to small and reasonable defaults (see issue template):
Size | Virtual Machine | CloudSQL instance |
---|---|---|
small | n2-highmem-4 | db-custom-1-4096 |
Monitoring Trial Managed Instances
Trial Managed Instance are automatically checked daily for expired trials. If Trial Managed Instance period exceeded 30 days, it will notify Cloud Team on Slack channel #cloud-notifications
. Cloud Team will notify instance requestor and ask for choosing one of the options:
Extend Trial Managed Instance
When trial expires and should be extended (by default 30 days), the instance requestor will create Managed Instance Trial Extend GitHub issue. Cloud Team will add trialAdditionalDays
to customer config.yaml
to ensure extended trial period is monitored.
Convert trial to paying customer
When a customer has decided to sign the deal, the instance requestor will create a Managed Instance Convert Trial to Paid GitHub issue. This is important so that the doesn’t get terminated after a time period as a trial instance would, and for cost attribution to trial vs production instances. Once the issue is raised, the Cloud Team will:
- cd
deploy-sourcegraph-managed/CUSTOMER
- modify GCP label ’
instanceType: production
’ inconfig.yaml
- follow modify GCP customer label
Requesting to change the subdomain
Upon conversion (or potentially earlier), you can request to change the domain name to a vanity subdomain (eg. acme-corp.sourcegraph.com
). To do so, raise a Change cloud instance subdomain request.
Note that changing the subdomain will require the admin to:
- reconfigure the auth provider (if using SSO). Auth will be broken until they do that.
- reconfigure the auth provider (if using permission syncing). Repository syncing will be broken until they do that.
- reconfigure webhooks if they’ve set those up.
- it will also break all hardcoded links to their sourcegraph instance
- cause some brief downtime
Be sure to set expectations with the site admin ahead of raising the issue and indicate the configuration steps required.
Teardown Trial Managed Instance
When trial expires and customer do not wish to sign the deal, instance requestor will open Teardown Managed Instance request
Trial Managed Instance creation flow (manual)
-
New trial managed instance request issue is open by CE or Growth Team (DRI Malo Marrec)
-
Cloud Team will receive new Trial Managed Instance request via email and on-call person should proceed to p.3 within 1 working day
-
Create Trial Managed Instance
Trial Managed Instance should be created according to the Managed Instance create process.
Important:
- Instance type should be trial
- Instance size should be small
- Customer name has to be max 10 characters (GCP project name limit -
sourcegraph-managed-SLUG
cannot execeed 30 characters). If customer SLUG has more characters:- set
customer endpoint
toSLUG.sourcegraph.com
- set
customer
with SLUG trimmed to 10 characters
- set
- Other parameters should be used from New Trial Managed Instance request.
-
Finalisation (Cloud Team member)
- checkout
<CUSTOMER>/create-instance
branch indeploy-sourcegraph-managed
repository - need to set the license on the instance (the license key should be added to the issue)
- run
mi set-license --license-key "$LICENSE_KEY"
- run
- when giving customer access is done via comment in New Trial Managed Instance request issue, alert in
#cloud-notifications
should be closed. - you can check if the password reset email was sent using SMTP provider dashboard
- checkout
FAQ
- How to check trial Managed Instances owned by Customer Engineer
- open GitHub Action
- click
Run workflow
- choose
Instance type
->trial
(required) - type
CE email responsible for Managed Instances
-> CE email (optional, without it will list all trials)
For other questions please use Managed Instance FAQ