You are here

Home » API reference » Fastly 7

README.txt in Fastly 7

Same filename and directory in other branches
  1. 8.3 README.txt
  2. 7.2 README.txt
Fastly
=======================

http://drupal.org/project/fastly

What Is Fastly?
---------------

Fastly is a CDN (Content Delivery Network), which is to say, we speed up
delivery of your website and its content to your users. When your client in
Moscow, Montana or Vriezenveen, Netherlands clicks on your site requesting
a piece of information, we want them to feel your speed of delivery. No
waiting. We want them to get to your closest point of presence—in
milliseconds—to get what they want.

Founded in 2011 Fastly delivers the world's only real-time content delivery
network. At Fastly we think slow is unacceptable. Fastly enables a
next-generation of businesses to give their users the best online and mobile
experience. The patent-pending Fastly Caching Software delivers static,
dynamic and streaming content with the lowest recorded time to first byte.
Our customers include (but certainly aren't limited to) Twitter, Guardian
UK, GitHub, AddThis, Wikia, Shazam, Wanelo, and Yammer.

Fastly is a San Francisco based company, located in the heart of SOMA.
We are venture backed by Battery Ventures, OATV, August Capital, and Amplify
Partners. We provide challenging work, opportunities to learn, high-quality
teammates and, most importantly, we have a lot of fun doing what we love.
We offer some great benefits like a Tahoe ski cabin, stocked fridge,
flexible schedules, lots of company happy hours, and a no-vacation policy.
We are close to MUNI and BART, and Caltrain is just a pleasant 15-minute stroll.

We offer competitive compensation, stock options, and health benefits.


Module Features
---------------

1. Account Sign Up/Sign In. If you are already an authenticated Fastly user,
You can simply enter your API key and service ID to start using Fastly
on your website. If I you are a site admin who wishes to begin using Fastly,
you can simply sign up and configure your service within the module.

2. Automated Purging. Content can be automatically purged when updated/created.
This is done through the Cache Expiration module. Otherwise, purging will occur
at the timeframe (TTL) in which you have specified within the module.

3. Manual purging. You have the ability to set the Time To Live (TTL) for your
content within the Fastly module. you can also take advantage of the default
setting already provided. Also, at anytime you desire, you can click on a button
within the module to manually purge all of thr content.


How To Install The Module?
--------------------------

1. Install Fastly (unpacking it to your Drupal
/sites/all/modules directory if you're installing by hand, for example).

2. Enable any Example modules in Admin menu > Site building > Modules.

3. Rebuild access permissions if you are prompted to.

4. Profit! Fastly will appear in your Configuration > Web services menu section.

If you find a problem, incorrect comment, obsolete or improper code or such,
please search for an issue about it at http://drupal.org/project/fastly/issues
If there isn't already an issue for it, please create a new one.

SSL and Fastly
--------------
Fastly can support SSL connections.
See http://docs.fastly.com/guides/21844521/23340542 for a list of different
options available.
If you are using SSL, you should add the following lines of code to your
settings.php

// Enable Faslty SSL connections.
if (isset($_SERVER['HTTP_FASTLY_SSL']) && $_SERVER['HTTP_FASTLY_SSL']) {
  $_SERVER['HTTPS'] = 'on';
}

Expire Module Integration
-------------------------
The Faslty module has integration with the Cache Expiration module
(https://www.drupal.org/project/expire).

You can enable this by visiting admin/config/system/expire.  You should see
Fastly in the list of modules that support external expiration.
Make sure you select "External expiration", and also ensure you untick "Include
base URL in expires".

Custom VCL
----------
Fastly gives you the ability to upload and use your own VCL file.
This needs to be enabled by contacting Fastly support and requesting it.

This module contains an example.vcl file, this is intended to be used with a
Drupal site running on Fastly.  It contains session cookie handling logic,
as well as excluding certain paths from being cached.

If you need to edit the VCL file for whatever reason, please be aware of the
following thing:
* Fastly uses Varnish 2, there are some differences in syntax between 2 and 3.
* Do not include any host information in the VCL, this is added later by Fastly.

File

README.txt
View source 
  1. Fastly

  2. =======================

  3. 

  4. http://drupal.org/project/fastly

  5. 

  6. What Is Fastly?

  7. ---------------

  8. 

  9. Fastly is a CDN (Content Delivery Network), which is to say, we speed up

  10. delivery of your website and its content to your users. When your client in

  11. Moscow, Montana or Vriezenveen, Netherlands clicks on your site requesting

  12. a piece of information, we want them to feel your speed of delivery. No

  13. waiting. We want them to get to your closest point of presence—in

  14. milliseconds—to get what they want.

  15. 

  16. Founded in 2011 Fastly delivers the world's only real-time content delivery

  17. network. At Fastly we think slow is unacceptable. Fastly enables a

  18. next-generation of businesses to give their users the best online and mobile

  19. experience. The patent-pending Fastly Caching Software delivers static,

  20. dynamic and streaming content with the lowest recorded time to first byte.

  21. Our customers include (but certainly aren't limited to) Twitter, Guardian

  22. UK, GitHub, AddThis, Wikia, Shazam, Wanelo, and Yammer.

  23. 

  24. Fastly is a San Francisco based company, located in the heart of SOMA.

  25. We are venture backed by Battery Ventures, OATV, August Capital, and Amplify

  26. Partners. We provide challenging work, opportunities to learn, high-quality

  27. teammates and, most importantly, we have a lot of fun doing what we love.

  28. We offer some great benefits like a Tahoe ski cabin, stocked fridge,

  29. flexible schedules, lots of company happy hours, and a no-vacation policy.

  30. We are close to MUNI and BART, and Caltrain is just a pleasant 15-minute stroll.

  31. 

  32. We offer competitive compensation, stock options, and health benefits.

  33. 

  34. 

  35. Module Features

  36. ---------------

  37. 

  38. 1. Account Sign Up/Sign In. If you are already an authenticated Fastly user,

  39. You can simply enter your API key and service ID to start using Fastly

  40. on your website. If I you are a site admin who wishes to begin using Fastly,

  41. you can simply sign up and configure your service within the module.

  42. 

  43. 2. Automated Purging. Content can be automatically purged when updated/created.

  44. This is done through the Cache Expiration module. Otherwise, purging will occur

  45. at the timeframe (TTL) in which you have specified within the module.

  46. 

  47. 3. Manual purging. You have the ability to set the Time To Live (TTL) for your

  48. content within the Fastly module. you can also take advantage of the default

  49. setting already provided. Also, at anytime you desire, you can click on a button

  50. within the module to manually purge all of thr content.

  51. 

  52. 

  53. How To Install The Module?

  54. --------------------------

  55. 

  56. 1. Install Fastly (unpacking it to your Drupal

  57. /sites/all/modules directory if you're installing by hand, for example).

  58. 

  59. 2. Enable any Example modules in Admin menu > Site building > Modules.

  60. 

  61. 3. Rebuild access permissions if you are prompted to.

  62. 

  63. 4. Profit! Fastly will appear in your Configuration > Web services menu section.

  64. 

  65. If you find a problem, incorrect comment, obsolete or improper code or such,

  66. please search for an issue about it at http://drupal.org/project/fastly/issues

  67. If there isn't already an issue for it, please create a new one.

  68. 

  69. SSL and Fastly

  70. --------------

  71. Fastly can support SSL connections.

  72. See http://docs.fastly.com/guides/21844521/23340542 for a list of different

  73. options available.

  74. If you are using SSL, you should add the following lines of code to your

  75. settings.php

  76. 

  77. // Enable Faslty SSL connections.

  78. if (isset($_SERVER['HTTP_FASTLY_SSL']) && $_SERVER['HTTP_FASTLY_SSL']) {

  79.   $_SERVER['HTTPS'] = 'on';

  80. }

  81. 

  82. Expire Module Integration

  83. -------------------------

  84. The Faslty module has integration with the Cache Expiration module

  85. (https://www.drupal.org/project/expire).

  86. 

  87. You can enable this by visiting admin/config/system/expire.  You should see

  88. Fastly in the list of modules that support external expiration.

  89. Make sure you select "External expiration", and also ensure you untick "Include

  90. base URL in expires".

  91. 

  92. Custom VCL

  93. ----------

  94. Fastly gives you the ability to upload and use your own VCL file.

  95. This needs to be enabled by contacting Fastly support and requesting it.

  96. 

  97. This module contains an example.vcl file, this is intended to be used with a

  98. Drupal site running on Fastly.  It contains session cookie handling logic,

  99. as well as excluding certain paths from being cached.

  100. 

  101. If you need to edit the VCL file for whatever reason, please be aware of the

  102. following thing:

  103. * Fastly uses Varnish 2, there are some differences in syntax between 2 and 3.

  104. * Do not include any host information in the VCL, this is added later by Fastly.