CSS File Not Updating on Deploy (Google AppEngine)

Following is what has worked for me.

1. Serve your css file from the static domain. This is automatically created by GAE.

   //static.{your-app-id}.appspot.com/{css-file-path}

2. Deploy your application. At this point your app will be broken.

3. change the version of the css file

   //static.{your-app-id}.appspot.com/{css-file-path}?v={version-Name}

4. deploy again.

Every time you change the css file. you will have to repeat 2,3 and 4.

I've seen this before on App Engine, even when using cache-busting query parameters like /stylesheets/default.css?{{ App.Version }}.

Here's my (unconfirmed) theory:

1. You push a new version by deploying or changing a new version to default.
2. While this update is being propagated to all GAE instances running your app...
3. ...someone hits your site.
4. The request for static resource default.css{{ App.Version }} is sent to Google's CDN, which doesn't yet have it.
5. Google's CDN asks GAE for the resource before propagation from step #2 is done for all instances.
6. If you're unlucky, GAE serves up the resource from an instance running the old version...
7. ...which now gets cached in Google's CDN as the authoritative "new" version.

When this (if this is what happens) happens, I can confirm that no amount of cache-busting browser work will help. The Google CDN servers are holding the wrong version.

To fix: The only way I've found to fix this is to deploy another version. You don't run the risk of this happening again (if you haven't made any CSS changes since the race condition), because even if the race condition occurs, presumably your first update is done by the time you deploy your second one, so all instances will be serving the correct version no matter what.