Test your akamai configuration with rspec to improve your confidence that you've configured it correctly, catch mistakes early and find out if it behaves strangely.

1. Akamai-rspec

2. Akamai
● Content Delivery Network
● Sits in front of your servers
● Caches your content
● Clients connect to edge node near them
● Helps your site go fast

3. Rspec
● Ruby unit testing framework
● Prefer pretty matchers over plain asserts
eg. expect(“foo”).to not_equal(“bar”)

4. Why use it?
● Check akamai config behaves how you expect
● Catch regressions in akamai config
● When akamai features do weird stuff
– Their WAF modifies behaviour in non enforcing

5. Matchy Matchers

6. be_permanently_redirected_to
expect(old).to be_permanently_redirected_to(new)
● Expect 301 redirect from old to new

7. be_temporarily_redirected_to
expect(old).to be_temporarily_redirected_to(new)
● Expect a 302 redirect from old to new

8. be_temporarily_redirected_to_with_trailing_slash
expect(old).to
be_temporarily_redirected_to_with_trailing_slash(new)
● Like be_temporarily_redirected_to
● Also expect the response location to have a '/' added

9. be_cacheable
expect(url).to be_cacheable
● When akamai debug headers are supplied, X-
Check-Cacheable is yes

10. have_no_cache_set
response = RestClient.get(url)
expect(response).to have_no_cache_set
● Cache-control = no-cache

11. not_be_cached
expect(url).to not_be_cached
● Requests the resource twice
● Expect x_cache header to say cache miss
● Expect response code to be 200

12. be_successful
response = RestClient.get(url)
expect(url).to be_successful
expect(response).to be_successful
● Expect response code to be 200

13. be_verifiably_secure
expect(url).to be_verifiably_secure
● The ssl cert can be verified

14. be_served_from_origin
expect(url).to be_served_from_origin origin
● Expect response code to be 200
● Expect x_cache_key header to include origin
url

15. honour_origin_cache_headers
expect(url).to honour_origin_cache_headers origin
● Check that akamai and origin cache headers
correspond
● Takes in to account expected differences

16. be_forwarded_to_index
expect(url + “/” channel).to
be_forwarded_to_index(channel)
● Expect response to have x-akamai-session-info
● Expect AKA_PM_FWD_URL header to end in
channel
● That means it's passing on the channel to origin
● Response code is 200

17. be_tier_distributed
expect(response).to be_tier_distributed
● Forces a cache miss (query string)
● Checks that x_cache_remote header is set

18. be_gzipped
expect(url).to be_gzipped
● Checks that response content is gzipped

19. have_cookie
expect(response).to have_cookie cookie
● Expect the response to contain the specified
cookie

20. have_cp_code
expect(url).to have_cp_code(cp_code)
● Cache key contains Content Provider Code
● 200 response

21. Getting it
● Unfortunately, didn't manage to open source it
in time
● Will be at github.com/realestate-com-au soon
● Contributions wanted, especially tests and
documentation
● Get in touch if you do use it

22. Thanks
● REA people that worked on it
– Mick Gannon, Nathan Reeves, Reed Kraft-Murphy,
Tom Partington
● REA for letting us open source stuff
● Adrian Muhrer for (promised) pre release
review
● Javier Turegano for manager approval