google/cloud-tools

PHP tools for Google Cloud Platform

Friday, July 20, 2018
by bshaffer
Repository
8 Watchers
4 Stars
126,066 Installations

PHP
3 Dependents
0 Suggesters
6 Forks
2 Open issues
26 Versions
13 % Grown

The README.md

Utilities for Google Cloud Platform

Install

Add google/cloud-tools to the require-dev section of your composer.json., _(*1)

You can also run the following command:, _(*2)

$ composer require google/cloud-tools --dev

Utilities

flex_exec

The cli script src/Utils/Flex/flex_exec is a tool for running a command with using the same Docker image as the application running on App Engine Flex., _(*3)

It spins up a Docker image of a Deployed App Engine Flexible App, and runs a command in that image. For example, if you are running Laravel application, you can invoke a command like php artisan migrate in the image., _(*4)

If the Flex application is requesting the cloudsql access (beta_settings, cloud_sql_instances), this tool also provides the connection to the same Cloud SQL instances., _(*5)

The command runs on virtual machines provided by Google Cloud Container Builder, and has access to the credentials of the Cloud Container Builder service account., _(*6)

Prerequisites

To use flex_exec, you will need:, _(*7)

An app deployed to Google App Engine Flex
The gcloud SDK installed and configured. See https://cloud.google.com/sdk/
The google/cloud-tools composer package

You may also need to grant the Cloud Container Builder service account any permissions needed by your command. For accessing Cloud SQL, you need to add Cloud SQL Client permission to the service account., _(*8)

You can find the service account configuration in the IAM tab in the Cloud Console under the name [your-project-number]@cloudbuild.gserviceaccount.com., _(*9)

Resource usage and billing

The tool uses virtual machine resources provided by Google Cloud Container Builder. Although a certain number of usage minutes per day is covered under a free tier, additional compute usage beyond that time is billed to your Google Cloud account. For more details, see: https://cloud.google.com/container-builder/pricing, _(*10)

If your command makes API calls or utilizes other cloud resources, you may also be billed for that usage. However, flex_exec does not use actual App Engine instances, and you will not be billed for additional App Engine instance usage., _(*11)

Example

src/Utils/Flex/flex_exec run -- php artisan migrate

Testing Utilities

There are various test utilities in the Google\Cloud\TestUtils namespace., _(*12)

Test examples

The example test cases are available in test/fixtures/appengine-standard directory., _(*13)

Environment variables

There are multiple environment variables to control the behavior of our test traits., _(*14)

All Traits

GOOGLE_PROJECT_ID: The project id for deploying the application.
GOOGLE_VERSION_ID: The version id for deploying the application.

AppEngineDeploymentTrait

GOOGLE_DEPLOYMENT_DELAY: Number of seconds to wait after the deployment has been triggered before continuing to execute tests.
GOOGLE_KEEP_DEPLOYMENT: Set to true to keep deployed app in place after test completion.
GOOGLE_SKIP_DEPLOYMENT: Set to true if you want to skip deployment.
RUN_DEPLOYMENT_TESTS: Set to true if you want to run deploy tests.

DevAppserverTestTrait

LOCAL_TEST_TARGETS: You can specify multiple yaml files if your test need multiple services.
PHP_CGI_PATH: Path to php-cgi for running dev_appserver.
RUN_DEVSERVER_TESTS: Set to true if you want to run tests.

The Versions

20/07 2018

dev-docs/env-vars

dev-docs/env-vars https://github.com/GoogleCloudPlatform/php-tools

PHP tools for Google Cloud Platform

library cloud-tools

PHP tools for Google Cloud Platform

google/cloud-tools

The README.md

Utilities for Google Cloud Platform

Install

Utilities

flex_exec

Prerequisites

Resource usage and billing

Example

Testing Utilities

Test examples

Environment variables

All Traits

AppEngineDeploymentTrait

DevAppserverTestTrait

The Versions

dev-docs/env-vars

The Requires

The Development Requires

by Takashi Matsuo

dev-master

The Requires

The Development Requires

by Takashi Matsuo

v0.8.1

The Requires

The Development Requires

by Takashi Matsuo

v0.8.0

The Requires

The Development Requires

by Takashi Matsuo

v0.7.2

The Requires

by Takashi Matsuo

v0.7.1

The Requires

by Takashi Matsuo

v0.7.0

The Requires

by Takashi Matsuo

dev-allows-skipping-deployment

The Requires

by Takashi Matsuo

v0.6.9

The Requires

by Takashi Matsuo

dev-bshaffer-patch-1

The Requires

by Takashi Matsuo

v0.6.8

The Requires

by Takashi Matsuo

v0.6.7

The Requires

The Development Requires

by Takashi Matsuo

v0.6.6

The Requires

The Development Requires

by Takashi Matsuo

v0.6.5

The Requires

The Development Requires

by Takashi Matsuo

v0.6.4

The Requires

The Development Requires

by Takashi Matsuo

dev-add-grpc-install

The Requires

The Development Requires

by Takashi Matsuo

v0.6.3

The Requires

The Development Requires

by Takashi Matsuo

v0.6.2