LOG IN SIGN UP
Documentation

Working with services

  Last updated August 21, 2017

A service is a user-defined set of caching rules and behavior for a website or application. The Fastly web interface allows you to create new services or edit existing ones and then activate your changes once you have things configured. The web interface also allows you to do other things with existing services, like rename them, compare them to each other, deactivate or reactivate them, and delete them.

Creating and editing services

Choosing between creating a new service or editing a version of an existing service depends largely on how you manage your web properties and the digital assets that make them up.

You might create a new service when you want to do things like:

You might edit a version of an existing service when you want to do things like:

Creating a new service

To create a new service, follow the steps below:

  1. Log in to the Fastly web interface and click the Configure link.
  2. Click the Create service button. The Create a new service page appears.

    the Create a new service page

  3. Fill out the Create a new service page as follows:
    • In the Name field, type a human-readable name for the new service. You can change this name at any time.
    • In the Domain field, type the domain name of your website. We need this information to properly route requests to your website.
    • In the Address field, type the IP address (or hostname) for your website's origin server.

      Transport Layer Security for service

  4. Fill out the Transport Layer Security (TLS) area as follows:

    • Leave the Enable TLS? default set to Yes if you want to enable TLS and secure the connection between Fastly and your origin. To enable TLS, a valid SSL certificate must be installed on your origin server and port 443 (or the specified port) must be open in the firewall. You can select No if you do not want to use TLS.
    • Leave the Verify certificate? default set to Yes if you want to verify the authenticity of the TLS certificate. Selecting No means the certificate will not be verified.

    • In the Certificate hostname field, type your certificate hostname associated with your TLS certificate. This value is matched against the certificate common name (CN) or a subject alternate name (SAN) depending on the certificate you were issued.
    • In the SNI hostname field, optionally specify your SNI hostname. This is generally only required when your origin is using shared hosting, such as Amazon S3, or when you use multiple certificates at your origin. See Setting the TLS hostname for more information.
    • In the TLS CA certificate field, optionally include your TLS CA certificate. You may want to provide the CA certificate if you're using a certificate that is either self-signed or signed by a Certificate Authority (CA) not commonly recognized by major browsers. See Specifying a TLS CA certificate for more information.
  5. Click the Create button. The new service appears in the list of services available.

Editing and activating versions of services

Fastly locks versions of services you've already activated to make rollbacks safer and provide version control. You can duplicate ("clone") any existing service version, active or inactive, and edit that cloned version. You must "activate" new versions of services in order to deploy their configurations. Configuration changes are never automatically activated.

To make changes to a service and activate a new version, follow the steps below:

  1. Log in to the Fastly web interface and click the Configure link. The Configure page appears.

    The Configure page

  2. Click the Configuration button. You can select Clone active to clone the active version of the service for editing, or you can select Edit to edit the latest draft of the service.

    The Configuration button

    The service version page appears.

    Activate service

  3. Click Activate. The new version of the service is activated.

Other things you can do

In addition to creating or editing services, you can view all your services, rename them, compare versions of them, deactivate or reactivate specific versions of them, and delete them.

Viewing all services

To view all your services, log in to the Fastly web interface. The All services page appears displaying a summary of all your services, sorted by requests per second.

the All services page

Renaming services

To rename your service, follow the steps below:

  1. Log in to the Fastly web interface and click the Configure link.
  2. From the service menu, select the appropriate service.
  3. Click the Options button to open the Manage service menu and select Rename.

    renaming a service

    The Rename your service pane appears.

    an editable service name

  4. Type the new service name and then click Rename. The new service name appears.

Comparing different service versions

To compare two versions of a service, follow the steps below:

  1. Log in to the Fastly web interface and click the Configure link.
  2. From the service menu, select the appropriate service.
  3. Click the Options button to open the Manage service menu and select Diff versions.

    selecting Diff versions from the Manage Service menu

    The Diff versions page appears. Removals are highlighted in red with a minus sign at the beginning of the line. Additions are highlighted in green with a plus sign at the beginning of the line.

    an example comparison of two service versions

You can change the compared service versions by selecting a different version number in the selection menus.

Deactivating a service

To deactivate a service, follow the steps below:

  1. Log in to the Fastly web interface and click the Configure link.
  2. From the service menu, select the appropriate service.
  3. Click the Options button to open the Manage service menu and select Deactivate.

    deactivate a service

You can also activate or deactivate a service via the API. Did you accidentally delete a service? We can help.

Reactivating a service

To reactivate a service, follow the steps below:

  1. Log in to the Fastly web interface and click the Configure link.
  2. From the service menu, select the appropriate service.
  3. Click the Configuration button and then select Clone active. The Domains page appears.
  4. Click Activate. The service is reactivated.
  5. If you removed the DNS CNAME records for the service's domains when you deactivated the service, you should add new DNS CNAME records now.

Deleting a service

Fastly allows you to delete any service you create, along with all of its versions. Fastly does not offer a way to delete specific versions of a service, however. Service versions are meant to be an historic log of the changes that were made to a service. To undo changes introduced by a particular service version, you can always go back to a previous version and reactivate it or clone a new service version based on any old version.

To delete any service along with all of its versions, follow the steps below:

  1. Log in to the Fastly web interface and click the Configure link.
  2. From the service menu, select the appropriate service.
  3. Click the Options button to open the Manage service menu and select Deactivate.

    deactivate a service

    The deactivate service warning appears.

    the Deactivate Service warning

  4. Click the Confirm and deactivate button to confirm you want to deactivate your service and acknowledge that you no longer want to serve traffic with it.
  5. Click the Options button again to open the Manage service menu and select Delete.

    delete a service

    The confirm delete window appears.

    the Confirm Delete window

  6. Click the Confirm and delete button to confirm that you want to delete the service.

Getting help with accidental service deletions

Services can be deactivated or deleted. Deactivated services can be reactivated at any time, but once they've been deleted you must contact Customer Support to have them restored. When sending your request, remember to include:

Customer Support will notify you when your service has been restored.


Back to Top