ghost-gcp-storage-adapter

Ghost adapter to store images into Google Cloud Storage.

:arrow_down: Installation

Google Cloud Storage Configuration

1. Create a project from Google Cloud Console
2. Be sure that Google Cloud Storage API is enable in APIs & Services > Library
3. Create a new Service Account in IAM & Admin > Service Accounts
4. Create new credentials for your service account in IAM & Admin > Service Accounts > <Your Service Account> > Actions > Manage Keys > Add Key
5. Download your credentials as a JSON file and renamed it to credentials.json
6. Create a bucket to store your files (use Fine-grained access control)

Server Configuration for production

1. Go to your Ghost instalation folder (the folder where you have the files config.production.json or config.development.json):

cd /your/ghost/instalation/folder

2. Create the adapters/storage folder inside the content folder:

mkdir -p content/adapters/storage

3. Install this package via NPM:

npm i ghost-gcp-storage-adapter

4. Copy the installed package into content/adapters/storage:

cp -r node_modules/ghost-gcp-storage-adapter content/adapters/storage/ghost-gcp-storage-adapter

5. Copy your credentials.json file into content/adapters/storage/ghost-gcp-storage-adapter

6. Add the next configuration to your config.production.json file:

"storage": {
  "active": "ghost-gcp-storage-adapter",
  "ghost-gcp-storage-adapter": {
    "projectId": "<your_google_cloud_project_id>",
    "keyFilename": "<your_ghost_instalation_folder>/content/adapters/storage/ghost-gcp-storage-adapter/credentials.json",
    "bucketName": "<your_bucket_name>"
  }
}

6. Restart Ghost

Configuration for development

If you want to contribute or test this adapter, you can use it locally by following the next instructions:

1. Follow the same steps to configure Google Cloud Storage
2. Fork this repo
3. Clone your fork in your computer
4. Install Ghost locally (Instructions)
5. In the folder where you installed Ghost, install the adapter locally

cd ghost_folder/
npm install /path/to/your/forked/repo

6. Create the adapters/storage folder inside the content folder:

mkdir -p content/adapters/storage

7. Copy the installed package into content/adapters/storage:

cp -r node_modules/ghost-gcp-storage-adapter content/adapters/storage/ghost-gcp-storage-adapter

8. Copy your credentials.json file into content/adapters/storage/ghost-gcp-storage-adapter
9. Stop Ghost and running it in development mode by using:

NODE_ENV=development ghost run

With this you'be able to see the logs in real time and test and debug this package.

:page_with_curl: License

MIT