bash-my-gcp
aims to assist people using Google Cloud Platform services from their bash command line, either on their linux workstation or in a cloud shell, by providing some shortcuts for operating on the platform.
Here you'll get to have a quick play with bash-my-gcp.
Prerequisites:
- a bash shell
- linux environment
Nice to have:
- A GCP account
- A GCP project
- Some instaces
Time to complete this tutorial: About 5 minutes
Click the Next button to move to the next step.
You'll need to load bash-my-gcp in to your environment to use it.
You can do this with the following command in your shell now:
source loader.sh
Once loaded you should then be able to try out some of the commands.
See the README.md file in the repository for how to add this to your regular bash environment.
Click the Next button to move to the next step.
To list the instances in your project type the following:
gci
To list instances who's name contains the word "web" you can type the following:
gci web
Instances can be stoped, started, reset and deleted with the following commands:
Stopping an instance:
gci-stop web-server1
Starting an instance:
gci-start web-server1
Resetting an instance:
gci-reset web-server1
Deleting an instance:
gci-delete web-server1
Tip: Tab completion is available for instance operations
Click the Next button to move to the next step.
gcloud allows you to store named configurations for your projects.
These configurations are collections of key-value pairs that influence how the gcloud commands work.
Named configurations are intended to be an advanced feature, and you can probably ignore them entirely if you only work with a single project.
You can create configuration profiles by using the gcpro-create command:
gcpro-create
This command requires:
- A name for your configuration
- Your gcloud account email
- Your project ID
You can list your saved configurations by typing:
gcpro
You can switch between configurations by typing:
gcpro config-name
Tip: If you dont know the name of your configuration profile you can use tab completion.
Click the Next button to move to the next step.
You can ssh to your instance using the following command:
gssh <external-IP>
Note: This command requires you have your configurations profiles project-ID value correctly set
gssh sets an extra ssh client option so that all the host keys of your projects instances are put in to a separate known_hosts file.
Click the Next button to move to the next step.
Each of the commands mentioned in this tutorial are basic bash functions that call the corresponding command, or sequence of commands, in gcloud.
You can find out what each of them are doing by executing the following command:
type gci
Click the Next button to move to the next step.
You completed this quick tutorial for bash-my-gcp!
If you have an idea or a fix; pull requests for bash-my-gcp are welcome
Don't Forget!
Ensure you clean up any resources you may have created during this tutorial so you dont get an unexpected bill