You'll want to login using an official Google account (i.e. if this is for your company, use the comapany Gmail account vs. a personal one.)
When logging in, you might be prompted to verify the account; if so, enter your cell number to get a verification e-mail or phone call.
Once verified, you'll have to agree to the terms of service; do that, and click continue.
Create a new project; here's an example project name:
Acme Co. Web Fonts
You'll then be directed to the "Welcome to Google Cloud Console" page.
Under "Cloud products", click "Go to Cloud Storage" under the "Cloud Storage" header.
You'll be taken to a URI that looks like so:
https://code.google.com/apis/console
Once there, you'll see this message:
"Google Cloud Storage is not active on this project"
Click the big blue "Enable" button.
Next, you'll see this message:
"You must sign up for billing before you will be able to create any buckets."
Google Cloud Storage: Pricing and Support
Click on the "Billing" link.
Click "Enable Billing" and setup your "Billing Profile".
Follow the instructions.
Once billing has been setup, continue on to the Google Cloud Storage Manager.
Create a new bucket by clicking the "New Bucket" button in top-right of interface.
If you're planning on setting up a CNAME for your bucket, you'll want to follow this naming convention:
fonts.acmecompany.com
Once you've created your bucket, upload your web fonts and related assets.
Note: For every file you want to share publicly, click the "Share Publicly" check mark in the file list view of the Google Cloud Storage Manager.
Next, create your CNAME:
fonts.acmecompany.com CNAME c.storage.googleapis.com
Where fonts.acmecompany.com is your bucket name and c.storage.googleapis.com is the host endpoint.
Now, download the gsutil
Python API to your Mac.
Read these docs:
Google Cloud Storage: Install gsutil
Google Cloud Storage: gsutil Tool
Tip: use $ gsutil config -b
and follow the instructions.
Once installed, and configured, you can access your bucket via the terminal shell.
Next, setup a CORS file:
Google Cloud Storage: Cross-Origin Resource Sharing (CORS)
<?xml version="1.0" encoding="UTF-8"?>
<CorsConfig>
<Cors>
<Origins>
<Origin>*</Origin>
</Origins>
<Methods>
<Method>GET</Method>
<Method>POST</Method>
<Method>HEAD</Method>
</Methods>
<ResponseHeaders>
<ResponseHeader>*</ResponseHeader>
</ResponseHeaders>
<MaxAgeSec>86400</MaxAgeSec>
</Cors>
</CorsConfig>
In terminal, get the CORS:
$ gsutil getcors gs://fonts.acmecompany.com/
Setting CORS:
$ gsutil setcors cors.xml gs://fonts.acmecompany.com/
Interesting info here:
Http Header Vary: Origin causes cache fail in Internet Explorer in Google Cloud Storage
Example usage:
$ gsutil setcors ~/Desktop/cors.xml gs://fonts.acmecompany.com
Setting CORS on gs://fonts.acmecompany.com/...
$ gsutil getcors gs://fonts.acmecompany.com
<?xml version="1.0" ?>
<CorsConfig>
<Cors>
<Origins>
<Origin>
*
</Origin>
</Origins>
<Methods>
<Method>
GET
</Method>
<Method>
POST
</Method>
<Method>
HEAD
</Method>
</Methods>
<ResponseHeaders>
<ResponseHeader>
*
</ResponseHeader>
</ResponseHeaders>
<MaxAgeSec>
86400
</MaxAgeSec>
</Cors>
</CorsConfig>
Some more info here:
Google Cloud Storage: Request Body Elements for CORS
Now, we need to setup index.html
and 404.html
files:
Google Cloud Storage: Website Configuration
Set default index and 404 error pages:
$ gsutil setwebcfg -m index.html -e 4xx.html gs://fonts.acmecompany.com
- Figure out how to set caching on uploaded files.
- Other optiomizations?
- Amazon Web Services Discussion Forums: S3, CORS and web fonts randomly failing to load?
- Google Groups: Google Cloud Storage: CORS and custom web fonts
If you need to connect to multiple Google Cloud Storage acounts (say, a work and personal account), you'll need to setup a .boto
file for each account.
Here's how I did it:
Run $ gsutil config -b
(from steps above) for each Google Cloud Storage account; afterwords, you'll find a ~/.boto
and a ~/.boto.bak
file (the latter being the .boto
file from the first time you ran the config setup). Re-name ~/.boto.bak
to something more useful (like .boto-other
) then you can add this line to your ~/.bash_profile
:
alias gsutil-other=BOTO_CONFIG=$HOME/.boto-other\ gsutil
Now you can run (for example):
$ gsutil-other getcors gs://fonts.personal-site.com/
... and:
$ gsutil getcors gs://fonts.work-site.com/
More information can be found here:
Google now recommend that we use json instead of xml