Google App Engine Ruby Samples

These are samples for using Ruby on Google App Engine. They are referenced from the docs.

See our other Google Cloud Platform github repos for sample applications and scaffolding for other frameworks and use cases.

Run Locally

Some samples have specific instructions. If there is a README in the sample folder, please refer to it for any additional steps required to run the sample.

In general, the samples typically require:

Install the Google Cloud SDK, including the gcloud tool, and gcloud app component.
Setup the gcloud tool. This provides authentication to Google Cloud APIs and services.
```
 gcloud init
```

Clone this repo.

 git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git

Open a sample folder, install dependencies, and run the sample:

 cd appengine/<sample-folder>/
 bundle install
 bundle exec ruby app.rb -p 8080

Visit the application at http://localhost:8080.

Deploying

Some samples in this repositories may have special deployment instructions. Refer to the README file in the sample folder.

Use the Google Developers Console to create a project/app id. (App id and project id are identical.)
Setup the gcloud tool, if you haven't already.
```
 gcloud init
```
Use gcloud to deploy your app.
```
 gcloud app deploy
```
Awesome! Your application is now live at your-app-id.appspot.com.

Testing

You must install/configure gcloud (above) and set the following environment variables to run most tests in this directory:

E2E: Enable end-to-end testing.
TEST_DIR: This is the relative path of the directory you're testing (e.g. appengine/analytics).
BUILD_ID: A unique ID for deployments.
GOOGLE_APPLICATION_CREDENTIALS: Path to credentials json file
E2E_GOOGLE_CLOUD_PROJECT: Project ID to deploy

Then run:

bundle install && bundle exec rspec --format documentation