1. Production plan¶

First, check via project:info that your project is not on the development plan, as domains can only be attached to production plans:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

$ symfony project:info
 Project ID:         nq3xa5jtywvyc
 Project title:      Symfony Documentation
 Status:             ok provisioned
 Owner:              [email protected]
 Region:             Europe (West)
 Plan:               Development
 Environments:       95/255 actives
 Storage:            5 Gb
 Users:              6/6

To move to a production plan, use the project:scale command:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

$ symfony project:scale
Scaling from Development to Standard...

  CPU    dev -> 1
  Memory dev -> 0.8GB
  Apps   dev -> 3     (including workers and services)


WARNING You are going to be charged for scaling up the project.
        Your credit card will be charged at the end of each month.

Do you confirm? [Y/n] Y
Project updated

2. Setup a domain¶

Attach a domain to your project via domain:attach to allow SymfonyCloud edge layer to route requests to the project for a specific domain:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

$ symfony domain:attach example.com
Waiting for activity 22jdotpwtrxz6 (Tugdual Saunier added domain example.com):
 Building application 'app' (runtime type: php:7.3, tree: a4a225e)
   Reusing existing build for this tree ID

 Provisioning certificates
   (Next refresh will be at 2019-05-28 11:39:30+00:00.)
   Environment certificates
   - certificate 84c845e: expiring on 2019-06-25 11:39:30+00:00, covering example.com


 Re-deploying environment nq3xa5jtywvyc-master-7rqtwti

Activity 22jdotpwtrxz6 succeeded
The domain example.com has been attached.

If you require access to the project before the domain name switch is done, you can create a hosts file entry on your computer and point it directly to one SymfonyCloud IP. To get SymfonyCloud IP addresses, run symfony account:ips --ingress.

On macOS and Linux, you can add that IP to your /etc/hosts file. On Windows the file is named c:\Windows\System32\Drivers\etc\hosts. You will need to be an admin user to be able to modify that file. After adding the line the file will look something like:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

##
# Host Database
#
# localhost is used to configure the loopback interface
# when the system is booting.  Do not change this entry.
##
127.0.0.1            localhost
255.255.255.255      broadcasthost
::1                  localhost

52.49.93.188 example.com

3. HTTPS¶

On SymfonyCloud, all environments support both HTTP and HTTPS.

If you don't bring your own certificates, SymfonyCloud provisions certificates using Let's Encrypt. Note that this setup requires that the DNS switch step is completed first.

Alternatively, you can bring your own certificates. This is particularly useful when switching over to SymfonyCloud as this avoids any interruption in HTTPS serving.

4. Switch DNS¶

Configure your DNS provider to point the project domain(s) to SymfonyCloud.

The precise way to do so varies depending on your registrar, but nearly all registrars should allow you to set a CNAME. Some might call it "Alias" or similar alternate names:

1. Obtain the CNAME target by running symfony cname;
2. Add a CNAME record for your desired domain (www.example.com) using the value obtained before.

5. Bonuses¶

The following steps are not required but good practices when going live with a SymfonyCloud project.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

crons:
    snapshot:
        # Take a snapshot automatically every night at 3 am (UTC).
        spec: '0 3 * * *'
        cmd: |
            if [ "$SYMFONY_BRANCH" = master ]; then
                croncape symfony env:snapshot:create --no-wait
            fi
    renewcert:
        # Force a redeploy at 8 am (UTC) on the 14th and 28th of every month.
        spec: '0 8 14,28 * *'
        cmd: |
            if [ "$SYMFONY_BRANCH" = master ]; then
                croncape symfony env:redeploy --no-wait
            fi

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

$ symfony integration:add
Please select the type of integration you want to add:
 [0] github
 [1] gitlab
 [2] health.email
 [3] health.pagerduty
 [4] health.slack
 [5] hipchat
 [6] webhook
 > 2
From (email): [email protected]
Recipients: [email protected]
Created integration efelccbyabjdi (type: health.email).
┌──────────────┬────────────────────┐
│   Property   │       Value        │
├──────────────┼────────────────────┤
│ from_address │ [email protected]  │
│ id           │ efelccbyabjdi      │
│ recipients   │ - [email protected] │
│ type         │ health.email       │
└──────────────┴────────────────────┘