docs

GCP

Requirements

• Cloud SDK

Overview

Developer's development environment is deployed by GCE. The instance name is called host-vm which is based on vmx-enabled instance image. Developer can create custom vmx-enabled image with $HOME/.necogcp.yml.

Usage

Setup your configuration file

First, download a credential to access your GCP account by following steps:

1. Configure $HOME/.necogcp.yml using necogcp-example.yml.
2. Run gcloud auth login with your GCP project.
3. Edit $HOME/.necogcp.yml. See config.md

Install necogcp command

necogcp command is used for creating a VM image, creating a VM instance, and so on.

make install-necogcp

Create vmx-enabled instance image for your project

necogcp create-image

If you want to update your existing image, re-run this command.

Use host-vm instance for your project

host-vm instance is deleted by at job which is created by necogcp create-instance

Please create vmx-enabled image in advance with above step.

necogcp create-instance

If you want to update your existing image, re-run this command.

Extend time to delete host-vm automatically

host-vm created by necogcp create-instance has a at job which deletes host-vm instance at 21:00 JST by default. If you want to extend the time, modify the at job owned by the root user. Also, if you want to change the deletion time of your host-vm instance permanently, modify the shutdown-at field in this example. This change affects only when executing necogcp create-instance.

For neco-test GCP project

See neco-test.md