diff --git a/Makefile b/Makefile index 476f10a3..4faf75b3 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,6 @@ VERSION=$(shell echo $(shell git describe --abbrev=0 --tags)+$(shell git rev-parse --short=8 HEAD)) BUILD=$(shell date +%FT%T%z) +GOCMD=go GO_VER=1.22 GOOS=linux GOARCH=amd64 @@ -7,20 +8,35 @@ PKG=github.com/uselagoon/build-deploy-tool LDFLAGS=-w -s -X ${PKG}/cmd.bdtVersion=${VERSION} -X ${PKG}/cmd.bdtBuild=${BUILD} -X "${PKG}/cmd.goVersion=${GO_VER}" test: fmt vet - go clean -testcache && go test -v ./... + $(GOCMD) clean -testcache && $(GOCMD) test -v ./... fmt: - go fmt ./... + $(GOCMD) fmt ./... vet: - go vet ./... + $(GOCMD) vet ./... run: fmt vet - go run ./main.go + $(GOCMD) run ./main.go build: fmt vet - CGO_ENABLED=0 go build -ldflags '${LDFLAGS}' -v + CGO_ENABLED=0 $(GOCMD) build -ldflags '${LDFLAGS}' -v docker-build: DOCKER_BUILDKIT=1 docker build --pull --build-arg GO_VER=${GO_VER} --build-arg VERSION=${VERSION} --build-arg BUILD=${BUILD} --rm -f Dockerfile -t build-deploy-image:local . docker run --entrypoint /bin/bash build-deploy-image:local -c 'build-deploy-tool version' + +docs: test + $(GOCMD) run main.go --docs + +MKDOCS_IMAGE ?= ghcr.io/amazeeio/mkdocs-material +MKDOCS_SERVE_PORT ?= 8000 + +.PHONY: docs/serve +docs/serve: + @echo "Starting container to serve documentation" + @docker run --rm -it \ + -p 127.0.0.1:$(MKDOCS_SERVE_PORT):$(MKDOCS_SERVE_PORT) \ + -v ${PWD}:/docs \ + --entrypoint sh $(MKDOCS_IMAGE) \ + -c 'mkdocs serve --dev-addr=0.0.0.0:$(MKDOCS_SERVE_PORT) -f mkdocs.yml' \ No newline at end of file diff --git a/README.md b/README.md index 0e59de21..eb7b86fe 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,6 @@ # Build and Deploy Resource Generator -This is a tool used to help with creating resources for Lagoon builds + + +This is a tool used with a [Lagoon Build](https://docs.lagoon.sh/concepts-basics/build-and-deploy-process/). It is currently not intended to be used outside of a build process. + diff --git a/cmd/root.go b/cmd/root.go index e88ae3cc..eab0da1a 100644 --- a/cmd/root.go +++ b/cmd/root.go @@ -21,15 +21,29 @@ import ( "os" "github.com/spf13/cobra" + "github.com/spf13/cobra/doc" ) +var docsFlag bool + // rootCmd represents the base command when called without any subcommands var rootCmd = &cobra.Command{ - Use: "lagoon-build", - Short: "A tool to help with generating Lagoon resources for Lagoon builds", + Use: "lagoon-build", + DisableAutoGenTag: true, + Short: "A tool to help with generating Lagoon resources for Lagoon builds", Long: `A tool to help with generating Lagoon resources for Lagoon builds This tool will read a .lagoon.yml file and also all the required environment variables from within a Lagoon build to help with generating the resources`, + RunE: func(cmd *cobra.Command, args []string) error { + if docsFlag { + err := doc.GenMarkdownTree(cmd, "docs/commands") + if err != nil { + return err + } + fmt.Println("Documentation updated") + } + return nil + }, } var templateCmd = &cobra.Command{ @@ -99,6 +113,9 @@ func init() { rootCmd.AddCommand(taskCmd) rootCmd.AddCommand(identifyCmd) rootCmd.AddCommand(validateCmd) + rootCmd.Flags().BoolVarP(&docsFlag, "docs", "", false, "Generate docs") + + rootCmd.Flags().MarkHidden("docs") rootCmd.PersistentFlags().StringP("lagoon-yml", "l", ".lagoon.yml", "The .lagoon.yml file to read") diff --git a/docs/buildrequirements.md b/docs/buildrequirements.md index 0b80a0bd..87fe278c 100644 --- a/docs/buildrequirements.md +++ b/docs/buildrequirements.md @@ -1,24 +1,27 @@ -# Build Requirements - Lagoon uses the following information injected into the build pod, and retrieved from files within the git repository to determine how an environment is built. -## Required Files +# Required Files + +These files are **_required_** by a build. + +The `.lagoon.yml` file has a `docker-compose-yaml` field that points to which file should be consumed, and this file is required. Typically it is `docker-compose.yaml`. + * `.lagoon.yml` * `docker-compose.yml` -### `.lagoon.yml` +## `.lagoon.yml` See the docs [here](https://docs.lagoon.sh/using-lagoon-the-basics/lagoon-yml/) -### `docker-compose.yml` +## `docker-compose.yml` See the docs [here](https://docs.lagoon.sh/using-lagoon-the-basics/docker-compose-yml/) -## Variables +# Variables These are variables that are injected into a build pod by `remote-controller`, some are provided by Lagoon core when a build is created, some are injected into the build from `remote-controller` -### Core provided +## Core provided -#### Main Variables +### Main Variables * `BUILD_TYPE` can be one of `branch|pullrequest|promote` * `PROJECT` is the safed version of the project name * `ENVIRONMENT` is the safed version of the environment name @@ -27,7 +30,7 @@ These are variables that are injected into a build pod by `remote-controller`, s * `ACTIVE_ENVIRONMENT` is populated with the current active environment if active/standby is enabled * `STANDBY_ENVIRONMENT` is populated with the current standby environment if active/standby is enabled -#### Pullrequest Variables +### Pullrequest Variables * `PR_TITLE` * `PR_NUMBER` * `PR_HEAD_BRANCH` @@ -35,34 +38,33 @@ These are variables that are injected into a build pod by `remote-controller`, s * `PR_BASE_BRANCH` * `PR_BASE_SHA` -#### Promotion Variables +### Promotion Variables * `PROMOTION_SOURCE_ENVIRONMENT` contains the source environment name if this is a promotion type build -#### Environment Variables +### Environment Variables * `LAGOON_PROJECT_VARIABLES` contains any project specific environment variables * `LAGOON_ENVIRONMENT_VARIABLES` contains any environment specific environment variables -### Monitoring Variables +## Monitoring Variables * `MONITORING_ALERTCONTACT` * `MONITORING_STATUSPAGEID` -#### Build Variables +### Build Variables * `SOURCE_REPOSITORY` is the git repository * `GIT_REF` is the git reference / commit * `SUBFOLDER` if the project is in a subfolder, this variable contains the directory to change to * `PROJECT_SECRET` is used for backups * `KUBERNETES` is the kubernetes cluster name from Lagoon -* `REGISTRY` is the registry that is passed from Lagoon (will be deprecated) -### Remote provided +## Remote provided -#### General variables +### General variables These are variables that can influence parts of a build * `LAGOON_FASTLY_NOCACHE_SERVICE_ID` is a default cache no cache service id that can be consumed * `NATIVE_CRON_POD_MINIMUM_FREQUENCY` changes the interval of which cronjobs go from inside cli pods to native k8s cronjobs (default 15m) -### Build Flags +## Build Flags The following are flags provided by `remote-controller` and used to influence build, these also have counterpart variables that omit the `FORCE|DEFAULT` from them that can be used inside of environment variables, `FORCE` flags cannot be overridden. * `LAGOON_FEATURE_FLAG_FORCE_ROOTLESS_WORKLOAD` @@ -74,17 +76,24 @@ The following are flags provided by `remote-controller` and used to influence bu * `LAGOON_FEATURE_FLAG_FORCE_RWX_TO_RWO` * `LAGOON_FEATURE_FLAG_DEFAULT_RWX_TO_RWO` -### Proxy related variables +!!! info + As new features are created, this list can grow. We will try to keep this list updated. + +## Proxy related variables If proxy has been enabled in `remote-controller`, then these variables will be injected to the buildpod to enabled proxy support * `HTTP_PROXY / http_proxy` * `HTTPS_PROXY / https_proxy` * `NO_PROXY / no_proxy` -### API and Remote provided +!!! info + Proxy is typically not provided, consult your Lagoon administrators if this is something you need to be provided to all environments within a `lagoon-remote`. + +## API and Remote provided + +## Backup related variables +These are all variables that are provided by either core or remote, for more information see the docs [here](https://docs.lagoon.sh/concepts-advanced/backups/) -### Backup related variables -These are all variables that are provided by either core or remote * `DEFAULT_BACKUP_SCHEDULE` * `MONTHLY_BACKUP_DEFAULT_RETENTION` * `WEEKLY_BACKUP_DEFAULT_RETENTION` @@ -93,4 +102,4 @@ These are all variables that are provided by either core or remote * `LAGOON_FEATURE_BACKUP_PROD_SCHEDULE` (remote) / `LAGOON_BACKUP_PROD_SCHEDULE` (API) * `LAGOON_FEATURE_BACKUP_DEV_SCHEDULE` (remote) / `LAGOON_BACKUP_DEV_SCHEDULE` (API) * `LAGOON_FEATURE_BACKUP_PR_SCHEDULE` (remote) / `LAGOON_BACKUP_PR_SCHEDULE` (API) -* `K8UP_WEEKLY_RANDOM_FEATURE_FLAG` +* `K8UP_WEEKLY_RANDOM_FEATURE_FLAG` \ No newline at end of file diff --git a/docs/buildstages.md b/docs/buildstages.md new file mode 100644 index 00000000..1e86c62c --- /dev/null +++ b/docs/buildstages.md @@ -0,0 +1,104 @@ +When a build pod first starts up, it runs through some checks to ensure that the docker-host it needs to talk to is available. It also establishes a client to use to talk to Kubernetes. + +# Git Checkout + +Once the setup is complete, the build proceeds to checkout the git repository and any submodules it may have. Any repositories configured as submodules must be allowed to be pulled using the same key as the primary git repository. + +!!! warning + This may need the `deploy key` of the project be assigned to a git user, and that user then granted access to the repositories required. + +# Kubernetes Setup + +This stage ensures that a client can talk to Kubernetes. Also, all builds are configured to talk to a dedicated container registry, in most cases this will be a Harbor that is configured in `lagoon-remote`, checks to ensure this information is present occur here too. + +# Initial Environment Setup + +This stage saves a copy of the `.lagoon.yml` and `docker-compose.yml` file into the namespace before the build proceeds. This allows administrators to perform debugging if required with a copy of these files to detect potential changes. + +# Docker Compose and Lagoon YAML Validations + +This stage validates the `.lagoon.yml` and associated `docker-compose.yml` files to ensure they are valid. This step can produce build warnings that describe issues that should be addressed, as warnings indicate that a failure may occur in the future if behaviour changes. + +# Variable Configuration + +This stage sets up variables used internally during the build to store and process information later during the build. + +# Container Registry Login + +This stage logs in to the internally provided container registry. As Lagoon also supports [user defined external container registries](https://docs.lagoon.sh/concepts-basics/lagoon-yml/#container-registries), these are also configured and logged in during this step. + +# Image Build + +This stage is where the images are built. By default `buildkit` is enabled, but this can be disabled by setting the `DOCKER_BUILDKIT=0` as a build scope variable. + +!!! info + These images are not tagged and are referenced in Lagoon deployments using the build image `SHA`. + +# Pre-Rollout Tasks + +This stage runs any pre-rollout tasks that may be configured in the `.lagoon.yml` file. These tasks are treated as a failure item and will result in a build failing if they fail. If you don't want these tasks to fail, you will need to write your tasks in a way to always `exit 0`. + +# Service Configuration 1 & 2 + +These stages proceed to configure autogenerated routes and any DBaaS services. + +# Route/Ingress Configuration + +This stage calculates and creates any ingress for the environment. + +# Route/Ingress Cleanup + +This stage calculates any ingress that need to be removed. Currently Lagoon will provide a warning in the build if it detects anything, but will not remove anything. + +Setting `LAGOON_FEATURE_FLAG_CLEANUP_REMOVED_LAGOON_ROUTES=enabled` as a global scope variable will ensure that any ingress previously detected will be removed during the next build. A warning will be produced in both situations to inform the user that something has taken place. + +# Route/Ingress Certificate Challenges + +If the `lagoon-remote` has been configured with cert-manager, and any ingress have certificate challenges that are still pending or failing, this stage will report them in a warning for the user to either confirm if the routes are required, or to ensure DNS is correctly configured. + +# Update Configmap + +This stage updates the configmap that stores variables from the project or environment in Lagoon, plus any of the variables that are provided by the build, typicaly prefixed with `LAGOON_`. + +# Image Push to Registry + +This stage pushes any built or pulled through images into the internally configured registry. + +!!! info + These images are not tagged and are referenced in Lagoon deployments using the build image `SHA`. + +# Deprecated Image Warnings + +If any images built or pulled contain an image that Lagoon has detected as deprecated, a warning will be shown here to indicate which images have issues. See more information in the docs [here](https://docs.lagoon.sh/docker-images/deprecated-images/). + +# Backup Configruation + +This stage configures any backup schedules as required. Backups in Lagoon use [k8up](https://k8up.io/). + +# Deployment Templating + +This stage templates out the deployments, this includes the Kubernetes kinds of `deployment`, `service`, `persistentvolumeclaim`, or any other kinds that may be supported. + +# Applying Deployments + +This stage actually applies the resources to Kubernetes and waits for the pods to rollout. Any errors here could be due to pods failing to start or schedule. The output of the failure should help indicate why. + +# Cronjob Cleanup + +This stage ensures that only cronjobs defined in the `.lagoon.yml` are configured by removing any that may have been removed from the `.lagoon.yml` file. + +# Post-Rollout tasks + +This stage runs any post-rollout tasks that may be configured in the `.lagoon.yml` file. These tasks are treated as a failure item and will result in a build failing if they fail. If you don't want these tasks to fail, you will need to write your tasks in a way to always `exit 0`. + +# Build and Deploy + +This stage indicates the completion of the build, a copy of the `.lagoon.yml` and `docker-compose.yml` files are saved again here to aid in future debugging if required. + +# Insights Gathering + +This stage runs after the build has completed, but will only generate warnings if it fails to complete. This is used by Lagoon to generate insights or collect security information about the images that were built and this is then sent to Lagoon. + +!!! info + This stage is not enabled by default, it can result in builds taking longer to show as complete. This stage will eventually be moved out of the build process to run externally to the build. + diff --git a/docs/commands/lagoon-build.md b/docs/commands/lagoon-build.md new file mode 100644 index 00000000..383f2916 --- /dev/null +++ b/docs/commands/lagoon-build.md @@ -0,0 +1,56 @@ +## lagoon-build + +A tool to help with generating Lagoon resources for Lagoon builds + +### Synopsis + +A tool to help with generating Lagoon resources for Lagoon builds +This tool will read a .lagoon.yml file and also all the required environment variables from +within a Lagoon build to help with generating the resources + +``` +lagoon-build [flags] +``` + +### Options + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + -h, --help help for lagoon-build + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build configuration](lagoon-build_configuration.md) - Generate configurations +* [lagoon-build identify](lagoon-build_identify.md) - Identify resources +* [lagoon-build tasks](lagoon-build_tasks.md) - Run tasks +* [lagoon-build template](lagoon-build_template.md) - Generate templates +* [lagoon-build validate](lagoon-build_validate.md) - Validate resources +* [lagoon-build version](lagoon-build_version.md) - Version information + diff --git a/docs/commands/lagoon-build_configuration.md b/docs/commands/lagoon-build_configuration.md new file mode 100644 index 00000000..ed628434 --- /dev/null +++ b/docs/commands/lagoon-build_configuration.md @@ -0,0 +1,51 @@ +## lagoon-build configuration + +Generate configurations + +### Synopsis + +Generate any configurations for Lagoon builds + +### Options + +``` + -h, --help help for configuration +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build](lagoon-build.md) - A tool to help with generating Lagoon resources for Lagoon builds +* [lagoon-build configuration fastly](lagoon-build_configuration_fastly.md) - Generate fastly configuration for a specific ingress domain + diff --git a/docs/commands/lagoon-build_configuration_fastly.md b/docs/commands/lagoon-build_configuration_fastly.md new file mode 100644 index 00000000..0d73bb00 --- /dev/null +++ b/docs/commands/lagoon-build_configuration_fastly.md @@ -0,0 +1,51 @@ +## lagoon-build configuration fastly + +Generate fastly configuration for a specific ingress domain + +``` +lagoon-build configuration fastly [flags] +``` + +### Options + +``` + -D, --domain string The .lagoon.yml file to read + -h, --help help for fastly +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build configuration](lagoon-build_configuration.md) - Generate configurations + diff --git a/docs/commands/lagoon-build_identify.md b/docs/commands/lagoon-build_identify.md new file mode 100644 index 00000000..06aec95f --- /dev/null +++ b/docs/commands/lagoon-build_identify.md @@ -0,0 +1,59 @@ +## lagoon-build identify + +Identify resources + +### Synopsis + +Identify resources for Lagoon builds + +### Options + +``` + -h, --help help for identify +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build](lagoon-build.md) - A tool to help with generating Lagoon resources for Lagoon builds +* [lagoon-build identify created-ingress](lagoon-build_identify_created-ingress.md) - Identify all created ingress object names for a specific environment +* [lagoon-build identify dbaas](lagoon-build_identify_dbaas.md) - Identify if any dbaas consumers are created +* [lagoon-build identify feature](lagoon-build_identify_feature.md) - Identify if a feature flag has been enabled +* [lagoon-build identify image-builds](lagoon-build_identify_image-builds.md) - Identify the configuration for building images for a Lagoon build +* [lagoon-build identify ingress](lagoon-build_identify_ingress.md) - Identify all ingress for a specific environment +* [lagoon-build identify ingress](lagoon-build_identify_ingress.md) - Identify all ingress for a specific environment +* [lagoon-build identify lagoon-services](lagoon-build_identify_lagoon-services.md) - Identify the lagoon services for a Lagoon build +* [lagoon-build identify native-cronjobs](lagoon-build_identify_native-cronjobs.md) - Identify any native cronjobs for a specific environment +* [lagoon-build identify primary-ingress](lagoon-build_identify_primary-ingress.md) - Identify the primary ingress for a specific environment + diff --git a/docs/commands/lagoon-build_identify_created-ingress.md b/docs/commands/lagoon-build_identify_created-ingress.md new file mode 100644 index 00000000..d99f625b --- /dev/null +++ b/docs/commands/lagoon-build_identify_created-ingress.md @@ -0,0 +1,50 @@ +## lagoon-build identify created-ingress + +Identify all created ingress object names for a specific environment + +``` +lagoon-build identify created-ingress [flags] +``` + +### Options + +``` + -h, --help help for created-ingress +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build identify](lagoon-build_identify.md) - Identify resources + diff --git a/docs/commands/lagoon-build_identify_dbaas.md b/docs/commands/lagoon-build_identify_dbaas.md new file mode 100644 index 00000000..82de4302 --- /dev/null +++ b/docs/commands/lagoon-build_identify_dbaas.md @@ -0,0 +1,50 @@ +## lagoon-build identify dbaas + +Identify if any dbaas consumers are created + +``` +lagoon-build identify dbaas [flags] +``` + +### Options + +``` + -h, --help help for dbaas +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build identify](lagoon-build_identify.md) - Identify resources + diff --git a/docs/commands/lagoon-build_identify_feature.md b/docs/commands/lagoon-build_identify_feature.md new file mode 100644 index 00000000..6da73c0e --- /dev/null +++ b/docs/commands/lagoon-build_identify_feature.md @@ -0,0 +1,50 @@ +## lagoon-build identify feature + +Identify if a feature flag has been enabled + +``` +lagoon-build identify feature [flags] +``` + +### Options + +``` + -h, --help help for feature +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build identify](lagoon-build_identify.md) - Identify resources + diff --git a/docs/commands/lagoon-build_identify_image-builds.md b/docs/commands/lagoon-build_identify_image-builds.md new file mode 100644 index 00000000..f9dc716b --- /dev/null +++ b/docs/commands/lagoon-build_identify_image-builds.md @@ -0,0 +1,50 @@ +## lagoon-build identify image-builds + +Identify the configuration for building images for a Lagoon build + +``` +lagoon-build identify image-builds [flags] +``` + +### Options + +``` + -h, --help help for image-builds +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build identify](lagoon-build_identify.md) - Identify resources + diff --git a/docs/commands/lagoon-build_identify_ingress.md b/docs/commands/lagoon-build_identify_ingress.md new file mode 100644 index 00000000..55f2176e --- /dev/null +++ b/docs/commands/lagoon-build_identify_ingress.md @@ -0,0 +1,50 @@ +## lagoon-build identify ingress + +Identify all ingress for a specific environment + +``` +lagoon-build identify ingress [flags] +``` + +### Options + +``` + -h, --help help for ingress +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build identify](lagoon-build_identify.md) - Identify resources + diff --git a/docs/commands/lagoon-build_identify_lagoon-services.md b/docs/commands/lagoon-build_identify_lagoon-services.md new file mode 100644 index 00000000..13baa9a5 --- /dev/null +++ b/docs/commands/lagoon-build_identify_lagoon-services.md @@ -0,0 +1,50 @@ +## lagoon-build identify lagoon-services + +Identify the lagoon services for a Lagoon build + +``` +lagoon-build identify lagoon-services [flags] +``` + +### Options + +``` + -h, --help help for lagoon-services +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build identify](lagoon-build_identify.md) - Identify resources + diff --git a/docs/commands/lagoon-build_identify_native-cronjobs.md b/docs/commands/lagoon-build_identify_native-cronjobs.md new file mode 100644 index 00000000..254e10f1 --- /dev/null +++ b/docs/commands/lagoon-build_identify_native-cronjobs.md @@ -0,0 +1,50 @@ +## lagoon-build identify native-cronjobs + +Identify any native cronjobs for a specific environment + +``` +lagoon-build identify native-cronjobs [flags] +``` + +### Options + +``` + -h, --help help for native-cronjobs +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build identify](lagoon-build_identify.md) - Identify resources + diff --git a/docs/commands/lagoon-build_identify_primary-ingress.md b/docs/commands/lagoon-build_identify_primary-ingress.md new file mode 100644 index 00000000..e03a6ba6 --- /dev/null +++ b/docs/commands/lagoon-build_identify_primary-ingress.md @@ -0,0 +1,50 @@ +## lagoon-build identify primary-ingress + +Identify the primary ingress for a specific environment + +``` +lagoon-build identify primary-ingress [flags] +``` + +### Options + +``` + -h, --help help for primary-ingress +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build identify](lagoon-build_identify.md) - Identify resources + diff --git a/docs/commands/lagoon-build_tasks.md b/docs/commands/lagoon-build_tasks.md new file mode 100644 index 00000000..8c9c6465 --- /dev/null +++ b/docs/commands/lagoon-build_tasks.md @@ -0,0 +1,52 @@ +## lagoon-build tasks + +Run tasks + +### Synopsis + +Will run Pre/Post/etc. tasks defined in a .lagoon.yml + +### Options + +``` + -h, --help help for tasks +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build](lagoon-build.md) - A tool to help with generating Lagoon resources for Lagoon builds +* [lagoon-build tasks post-rollout](lagoon-build_tasks_post-rollout.md) - Will run post rollout tasks defined in .lagoon.yml +* [lagoon-build tasks pre-rollout](lagoon-build_tasks_pre-rollout.md) - Will run pre rollout tasks defined in .lagoon.yml + diff --git a/docs/commands/lagoon-build_tasks_post-rollout.md b/docs/commands/lagoon-build_tasks_post-rollout.md new file mode 100644 index 00000000..ff078274 --- /dev/null +++ b/docs/commands/lagoon-build_tasks_post-rollout.md @@ -0,0 +1,51 @@ +## lagoon-build tasks post-rollout + +Will run post rollout tasks defined in .lagoon.yml + +``` +lagoon-build tasks post-rollout [flags] +``` + +### Options + +``` + -h, --help help for post-rollout + -n, --namespace string The environments environment variables JSON payload +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build tasks](lagoon-build_tasks.md) - Run tasks + diff --git a/docs/commands/lagoon-build_tasks_pre-rollout.md b/docs/commands/lagoon-build_tasks_pre-rollout.md new file mode 100644 index 00000000..d87a472c --- /dev/null +++ b/docs/commands/lagoon-build_tasks_pre-rollout.md @@ -0,0 +1,51 @@ +## lagoon-build tasks pre-rollout + +Will run pre rollout tasks defined in .lagoon.yml + +``` +lagoon-build tasks pre-rollout [flags] +``` + +### Options + +``` + -h, --help help for pre-rollout + -n, --namespace string The environments environment variables JSON payload +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build tasks](lagoon-build_tasks.md) - Run tasks + diff --git a/docs/commands/lagoon-build_template.md b/docs/commands/lagoon-build_template.md new file mode 100644 index 00000000..cb458f5e --- /dev/null +++ b/docs/commands/lagoon-build_template.md @@ -0,0 +1,55 @@ +## lagoon-build template + +Generate templates + +### Synopsis + +Generate any templates for Lagoon builds + +### Options + +``` + -h, --help help for template +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build](lagoon-build.md) - A tool to help with generating Lagoon resources for Lagoon builds +* [lagoon-build template autogenerated-ingress](lagoon-build_template_autogenerated-ingress.md) - Generate the autogenerated ingress templates for a Lagoon build +* [lagoon-build template backup-schedule](lagoon-build_template_backup-schedule.md) - Generate the backup schedule templates for a Lagoon build +* [lagoon-build template dbaas](lagoon-build_template_dbaas.md) - Generate the DBaaS templates for a Lagoon build +* [lagoon-build template ingress](lagoon-build_template_ingress.md) - Generate the ingress templates for a Lagoon build +* [lagoon-build template lagoon-services](lagoon-build_template_lagoon-services.md) - Generate the lagoon service templates for a Lagoon build + diff --git a/docs/commands/lagoon-build_template_autogenerated-ingress.md b/docs/commands/lagoon-build_template_autogenerated-ingress.md new file mode 100644 index 00000000..cd79e471 --- /dev/null +++ b/docs/commands/lagoon-build_template_autogenerated-ingress.md @@ -0,0 +1,50 @@ +## lagoon-build template autogenerated-ingress + +Generate the autogenerated ingress templates for a Lagoon build + +``` +lagoon-build template autogenerated-ingress [flags] +``` + +### Options + +``` + -h, --help help for autogenerated-ingress +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build template](lagoon-build_template.md) - Generate templates + diff --git a/docs/commands/lagoon-build_template_backup-schedule.md b/docs/commands/lagoon-build_template_backup-schedule.md new file mode 100644 index 00000000..d1f6e2fd --- /dev/null +++ b/docs/commands/lagoon-build_template_backup-schedule.md @@ -0,0 +1,51 @@ +## lagoon-build template backup-schedule + +Generate the backup schedule templates for a Lagoon build + +``` +lagoon-build template backup-schedule [flags] +``` + +### Options + +``` + -h, --help help for backup-schedule + --version string The version of k8up used. (default "v1") +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build template](lagoon-build_template.md) - Generate templates + diff --git a/docs/commands/lagoon-build_template_dbaas.md b/docs/commands/lagoon-build_template_dbaas.md new file mode 100644 index 00000000..ad513029 --- /dev/null +++ b/docs/commands/lagoon-build_template_dbaas.md @@ -0,0 +1,50 @@ +## lagoon-build template dbaas + +Generate the DBaaS templates for a Lagoon build + +``` +lagoon-build template dbaas [flags] +``` + +### Options + +``` + -h, --help help for dbaas +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build template](lagoon-build_template.md) - Generate templates + diff --git a/docs/commands/lagoon-build_template_ingress.md b/docs/commands/lagoon-build_template_ingress.md new file mode 100644 index 00000000..61b72497 --- /dev/null +++ b/docs/commands/lagoon-build_template_ingress.md @@ -0,0 +1,50 @@ +## lagoon-build template ingress + +Generate the ingress templates for a Lagoon build + +``` +lagoon-build template ingress [flags] +``` + +### Options + +``` + -h, --help help for ingress +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build template](lagoon-build_template.md) - Generate templates + diff --git a/docs/commands/lagoon-build_template_lagoon-services.md b/docs/commands/lagoon-build_template_lagoon-services.md new file mode 100644 index 00000000..ee669771 --- /dev/null +++ b/docs/commands/lagoon-build_template_lagoon-services.md @@ -0,0 +1,50 @@ +## lagoon-build template lagoon-services + +Generate the lagoon service templates for a Lagoon build + +``` +lagoon-build template lagoon-services [flags] +``` + +### Options + +``` + -h, --help help for lagoon-services +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build template](lagoon-build_template.md) - Generate templates + diff --git a/docs/commands/lagoon-build_validate.md b/docs/commands/lagoon-build_validate.md new file mode 100644 index 00000000..650fbbf8 --- /dev/null +++ b/docs/commands/lagoon-build_validate.md @@ -0,0 +1,54 @@ +## lagoon-build validate + +Validate resources + +### Synopsis + +Validate resources for Lagoon builds + +### Options + +``` + -h, --help help for validate + --print-resulting-lagoonyml Display the resulting, post merging, lagoon.yml file. +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build](lagoon-build.md) - A tool to help with generating Lagoon resources for Lagoon builds +* [lagoon-build validate docker-compose](lagoon-build_validate_docker-compose.md) - Verify docker-compose file for compatability with this tool +* [lagoon-build validate docker-compose-with-errors](lagoon-build_validate_docker-compose-with-errors.md) - Verify docker-compose file for compatability with this tool with next versions of compose-go library +* [lagoon-build validate lagoon-yml](lagoon-build_validate_lagoon-yml.md) - Verify .lagoon.yml and environment for compatability with this tool + diff --git a/docs/commands/lagoon-build_validate_docker-compose-with-errors.md b/docs/commands/lagoon-build_validate_docker-compose-with-errors.md new file mode 100644 index 00000000..30bdf54f --- /dev/null +++ b/docs/commands/lagoon-build_validate_docker-compose-with-errors.md @@ -0,0 +1,52 @@ +## lagoon-build validate docker-compose-with-errors + +Verify docker-compose file for compatability with this tool with next versions of compose-go library + +``` +lagoon-build validate docker-compose-with-errors [flags] +``` + +### Options + +``` + --docker-compose string The docker-compose.yml file to read. (default "docker-compose.yml") + -h, --help help for docker-compose-with-errors +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + --print-resulting-lagoonyml Display the resulting, post merging, lagoon.yml file. + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build validate](lagoon-build_validate.md) - Validate resources + diff --git a/docs/commands/lagoon-build_validate_docker-compose.md b/docs/commands/lagoon-build_validate_docker-compose.md new file mode 100644 index 00000000..c91aa683 --- /dev/null +++ b/docs/commands/lagoon-build_validate_docker-compose.md @@ -0,0 +1,52 @@ +## lagoon-build validate docker-compose + +Verify docker-compose file for compatability with this tool + +``` +lagoon-build validate docker-compose [flags] +``` + +### Options + +``` + --docker-compose string The docker-compose.yml file to read. (default "docker-compose.yml") + -h, --help help for docker-compose +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + --print-resulting-lagoonyml Display the resulting, post merging, lagoon.yml file. + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build validate](lagoon-build_validate.md) - Validate resources + diff --git a/docs/commands/lagoon-build_validate_lagoon-yml.md b/docs/commands/lagoon-build_validate_lagoon-yml.md new file mode 100644 index 00000000..a768fe04 --- /dev/null +++ b/docs/commands/lagoon-build_validate_lagoon-yml.md @@ -0,0 +1,51 @@ +## lagoon-build validate lagoon-yml + +Verify .lagoon.yml and environment for compatability with this tool + +``` +lagoon-build validate lagoon-yml [flags] +``` + +### Options + +``` + -h, --help help for lagoon-yml +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + --print-resulting-lagoonyml Display the resulting, post merging, lagoon.yml file. + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build validate](lagoon-build_validate.md) - Validate resources + diff --git a/docs/commands/lagoon-build_version.md b/docs/commands/lagoon-build_version.md new file mode 100644 index 00000000..e5fd481a --- /dev/null +++ b/docs/commands/lagoon-build_version.md @@ -0,0 +1,50 @@ +## lagoon-build version + +Version information + +``` +lagoon-build version [flags] +``` + +### Options + +``` + -h, --help help for version +``` + +### Options inherited from parent commands + +``` + -a, --active-environment string Name of the active environment if known + -b, --branch string The name of the branch + -d, --build-type string The type of build (branch, pullrequest, promote) + --default-backup-schedule string The default backup schedule to use + -e, --environment-name string The environment name to check + -E, --environment-type string The type of environment (development or production) + --environment-variables string The JSON payload for environment scope variables + -A, --fastly-api-secret-prefix string The fastly secret prefix to use (default "fastly-api-") + -F, --fastly-cache-no-cache-id string The fastly cache no cache service ID to use + -f, --fastly-service-id string The fastly service ID to use + --ignore-missing-env-files Ignore missing env_file files (true by default, subject to change). (default true) + --ignore-non-string-key-errors Ignore non-string-key docker-compose errors (true by default, subject to change). (default true) + --images string JSON representation of service:image reference + -L, --lagoon-version string The lagoon version + -l, --lagoon-yml string The .lagoon.yml file to read (default ".lagoon.yml") + --lagoon-yml-override string The .lagoon.yml override file to read for merging values into target lagoon.yml (default ".lagoon.override.yml") + -M, --monitoring-config string The monitoring contact config if known + -m, --monitoring-status-page-id string The monitoring status page ID if known + -p, --project-name string The project name + --project-variables string The JSON payload for project scope variables + -B, --pullrequest-base-branch string The pullrequest base branch + -H, --pullrequest-head-branch string The pullrequest head branch + -P, --pullrequest-number string The pullrequest number + --pullrequest-title string The pullrequest title + -T, --saved-templates-path string Path to where the resulting templates are saved (default "/kubectl-build-deploy/lagoon/services-routes") + -s, --standby-environment string Name of the standby environment if known + -t, --template-path string Path to the template on disk (default "/kubectl-build-deploy/") +``` + +### SEE ALSO + +* [lagoon-build](lagoon-build.md) - A tool to help with generating Lagoon resources for Lagoon builds + diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 00000000..24abc4d5 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,5 @@ +![lagoon-build-deploy logo](lagoon-build-deploy.png){: width=100} + +This is a tool used with a [Lagoon Build](https://docs.lagoon.sh/concepts-basics/build-and-deploy-process/). It is currently not intended to be used outside of a build process. + +These docs will be used to describe the build tool and its behaviours in more depth. \ No newline at end of file diff --git a/docs/lagoon-build-deploy.png b/docs/lagoon-build-deploy.png new file mode 100644 index 00000000..cdabcc41 Binary files /dev/null and b/docs/lagoon-build-deploy.png differ diff --git a/go.mod b/go.mod index d5b3cf66..9d7b09b6 100644 --- a/go.mod +++ b/go.mod @@ -29,6 +29,7 @@ require ( ) require ( + github.com/cpuguy83/go-md2man/v2 v2.0.4 // indirect github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect github.com/distribution/distribution/v3 v3.0.0-20210316161203-a01c71e2477e // indirect github.com/docker/go-connections v0.5.0 // indirect @@ -61,6 +62,7 @@ require ( github.com/mxk/go-flowrate v0.0.0-20140419014527-cca7078d478f // indirect github.com/opencontainers/go-digest v1.0.0 // indirect github.com/pkg/errors v0.9.1 // indirect + github.com/russross/blackfriday/v2 v2.1.0 // indirect github.com/sergi/go-diff v1.1.0 // indirect github.com/shopspring/decimal v1.4.0 // indirect github.com/sirupsen/logrus v1.9.3 // indirect diff --git a/go.sum b/go.sum index 4df037a8..4b142d6d 100644 --- a/go.sum +++ b/go.sum @@ -129,6 +129,7 @@ github.com/coreos/pkg v0.0.0-20180928190104-399ea9e2e55f/go.mod h1:E3G3o1h8I7cfc github.com/cpuguy83/go-md2man v1.0.10/go.mod h1:SmD6nW6nTyfqj6ABTjUi3V3JVMnlJmwcJI5acqYI6dE= github.com/cpuguy83/go-md2man/v2 v2.0.0-20190314233015-f79a8a8ca69d/go.mod h1:maD7wRr/U5Z6m/iR4s+kqSMx2CaBsrgA7czyZG/E6dU= github.com/cpuguy83/go-md2man/v2 v2.0.0/go.mod h1:maD7wRr/U5Z6m/iR4s+kqSMx2CaBsrgA7czyZG/E6dU= +github.com/cpuguy83/go-md2man/v2 v2.0.4 h1:wfIWP927BUkWJb2NmU/kNDYIBTh/ziUX91+lVfRxZq4= github.com/cpuguy83/go-md2man/v2 v2.0.4/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o= github.com/creack/pty v1.1.7/go.mod h1:lj5s0c3V2DBrqTV7llrYr5NG6My20zk30Fl46Y7DoTY= github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E= @@ -716,6 +717,7 @@ github.com/rogpeppe/go-internal v1.12.0 h1:exVL4IDcn6na9z1rAb56Vxr+CgyK3nn3O+epU github.com/rogpeppe/go-internal v1.12.0/go.mod h1:E+RYuTGaKKdloAfM02xzb0FW3Paa99yedzYV+kq4uf4= github.com/russross/blackfriday v1.5.2/go.mod h1:JO/DiYxRf+HjHt06OyowR9PTA263kcR/rfWxYHBV53g= github.com/russross/blackfriday/v2 v2.0.1/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM= +github.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk= github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM= github.com/ryanuber/columnize v0.0.0-20160712163229-9b3edd62028f/go.mod h1:sm1tb6uqfes/u+d4ooFouqFdy9/2g9QGwK3SQygK0Ts= github.com/ryanuber/columnize v2.1.0+incompatible/go.mod h1:sm1tb6uqfes/u+d4ooFouqFdy9/2g9QGwK3SQygK0Ts= diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 00000000..71c9214f --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,50 @@ +site_name: 'Lagoon Build Deploy Tool' +site_url: https://uselagoon.github.io/build-deploy-tool/ +repo_url: https://github.com/uselagoon/build-deploy-tool/ +repo_name: uselagoon/build-deploy-tool +edit_uri: edit/main/docs +site_author: The Lagoon Authors + +theme: + name: 'material' + palette: + # Palette toggle for light mode + - primary: 'blue' + accent: 'light blue' + toggle: + icon: material/weather-night + name: Switch to dark mode + # Palette toggle for dark mode + - scheme: slate + primary: 'blue' + toggle: + icon: material/brightness-7 + name: Switch to light mode + # favicon: lagoon-build-icon.png + icon: + logo: fontawesome/solid/terminal + repo: fontawesome/brands/github + +extra: + analytics: + provider: google + property: G-W1SJFEVFDB + +markdown_extensions: + - toc: + permalink: "#" + baselevel: 2 + - admonition + - attr_list + - tables + - pymdownx.highlight + - pymdownx.superfences + +plugins: + - search + +nav: + - Home: index.md + - Build Stages: buildstages.md + - Build Requirements: buildrequirements.md + - Commands: commands/lagoon-build.md