Netbox GCP installer

This repo contains terraform and kubernetes configuration to install netbox into an empty GCP project.
Explore the docs »

View Demo · Report Bug · Request Feature

This project is designed to easily deploy netbox into an GCP project in an opinonated way.

Features:

• Deploy netbox onto GKE autpilot cluster using the bootc helm chart: https://github.com/bootc/netbox-chart
• Use a CloudSQL posgresql for database
• Use a GCP memorystore for redis instance
• Create DNS records in managed zone
• Create SSL certs using Letsencrypt and cert-manager
• Setup and configure necessary infrastructure to support Okta authentication
  • ingress-nginx
  • vouch-proxy
  • Creates Okta OIDC application configuration via terraform
  • creates a standard set of groups in netbox after deployment

(back to top)

• Terraform
• Helm
• Garden

(back to top)

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

• Homebrew on Mac

  brew tap garden-io/garden
  brew install garden-cli

• Installation instructions: https://docs.garden.io/getting-started/1-installation

• Homebrew on Mac

  brew install --cask google-cloud-sdk

• For other Operating system follow the directions here: https://cloud.google.com/sdk/docs/install

• Setting up the Google Cloud SDK

  gcloud init

• Make sure to login with your account and set the default login

  gcloud auth login
  gcloud auth application-default login

  https://cloud.google.com/sdk/docs/initializing

• Follow the directions here to create a gcp project: Creating a project

• this step is required if you want to setup a hostname to access netbox
• Create a public zone

1. Clone the repo

   git clone https://github.com/TakeoffTech/netbox-gcp-deployment.git

(back to top)

The current setup allows you to deploy netbox to empty gcp project.

To set these variable before running garden deploy you have two options:

1. simply set the ENV variable in your shell:

export ENV_VARIABLE=myconfig

2. create a garden.env or garden..env file: Variable files (varfiles)

echo garden_variable_name=myconfig >> garden.env

We automatically create dns records for netbox using the google_managed_zone domain. If you are deploying into the prod environment, it will create netbox.<google_managed_zone.domain>. If the dns zone contains netbox. we assume google_managed_zone is a subdomain for netbox (ie netbox.domain.local) and will create a record just for <google_managed_zone.domain>. When you have disable_okta_auth set to false we will create a record for vouch-proxy for clients and okta to access and they are created like this vouch.<google_managed_zone.domain> if it's a netbox. subdomain. If it's not a subdomain it will create vouch-netbox.<google_managed_zone.domain> for vouch-proxy.

For development environment, replace netbox with netbox-user-<local.username>

• Your google project ID

  export GOOGLE_PROJECT=<project_id>

• We default everything to the us-central1 region. You can override this with the GOOGLE_REGION environment variable. You can find the list of GCP regions here: https://cloud.google.com/compute/docs/regions-zones#available

  export GOOGLE_REGION=regionID

• Run garden deploy

  garden deploy

• Delete the environment

  garden delete env

• Currently we do not destroy the GKE cluster when deleting the environment, run this to cleanup the project and GKE cluster

  garden plugins terraform destroy-root

(back to top)

• [] Feature 1
• [] Feature 2
• [] Feature 3
  • [] Nested Feature

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Project Link: https://github.com/TakeoffTech/netbox-gcp-deployment

(back to top)

(back to top)