Project status

This project is no longer actively maintained, and remains here as an archive of this work.

Introduction

Cloud Playground is a place for developers to experiment and play with some of the services offered by the Google Cloud Platform (http://cloud.google.com/), such as Google App Engine, Google Cloud Storage and Google Cloud SQL. Think of the playground as an easy way to get to know these services, or just quickly try out a new API, without having to download the SDK or having to run appcfg.py update every time you want to test your changes.

About this project

This project contains the source code for the Cloud Playground, so you can see how the playground works, develop your own tools and experiments, or just create your own private playground using an App Engine app id you created.

Try it out!

You can try out the Cloud Playground here:

https://cloud-playground.appspot.com/

Using the source

There are two important projects which together create the Cloud Playground:

1. mimic is a regular (or "special", depending on how you look at things) Python App Engine app, which serves as a development server (similar to the App Engine SDK "dev_appserver"), but which runs in the production App Engine environment, providing you access to the production APIs and environment while still offering a quick and easy way to test out bits of code.

2. bliss (this project) is an experimental, trivial browser based code editor which lets edit code in the mimic virtual file system (backed by the App Engine datastore), providing you with a user interface so you can see what the mimic app can do for you.

Creating a private cloud playground

1. Create an App Engine app id where you will run your own private Cloud Playground

2. Create a git clone of bliss and its submodules:

```bash
git clone --recursive https://github.com/GoogleCloudPlatform/cloud-playground
cd cloud-playground
```

1. Modify the the various handlers: sections in the various *.yaml files (app.yaml, playground.yaml etc.) to require admin login (login: admin) and https (secure: always)

2. Optionally, try running the cloud playground on http://localhost:8080/

```bash
scripts/run.sh
```

1. Deploy the modified app to the app id you just created

```bash
scripts/deploy.sh --application your-app-id
```

1. Verify that all the URL handlers are indeed correctly locked down

2. Have fun!

Other fun places to play

• Go Playground
• AJAX APIs Playground
• OAuth 2.0 Playground
• Google Mirror API Playground
• devtable
• Codeenvy

License(s)

Note, the Cloud Playground includes libraries that are licensed under terms other than Apache 2.0.

• Bliss (i.e the source code in this repo) — LICENSE file

• AngularJS — https://github.com/angular/angular.js/blob/master/LICENSE

• Karma — https://github.com/karma-runner/karma/blob/master/LICENSE

• CodeMirror by Marijn Haverbeke — http://codemirror.net/LICENSE

• Some subdirectories of the CodeMirror distribution include their own LICENSE files, and are released under different licences

• Twitter Bootstrap — https://github.com/twitter/bootstrap/blob/master/LICENSE

• Werkzeug — https://github.com/mitsuhiko/werkzeug/blob/master/LICENSE

• Flask — http://flask.pocoo.org/docs/license/