A Whole bunch of readme edits
This commit is contained in:
Nicholas J. Parks
Nanne Baars
parent
a10d926859
commit
9990023d98
@ -1,15 +1,15 @@
|
||||
# Serverless MVN builds Featuring AWS
|
||||
|
||||
This Quick Start is the foundation where other of the AWS quickstarts begin. This quickstart only BUILDS the `webgoat-server` spring boot jar. If you want to also run it on AWS skip to the other AWS quickstarts
|
||||
This Quick Start forms the basis for the other AWS quickstarts. This only BUILDS the `webgoat-server` spring boot jar. If you want to also run it on AWS skip to the other AWS quickstarts
|
||||
|
||||
Before you Begin
|
||||
1. Do you have an AWS Account?
|
||||
2. Can you create an S3 Bucket?
|
||||
3. Can you create a KMS Key?
|
||||
4. Do you know that Cloud Formation is?
|
||||
4. Do you know what Cloud Formation is?
|
||||
5. Do you have enough permissions to do any real work in said AWS Account?
|
||||
|
||||
If you said no to any of those...hope over to [docs](https://aws.amazon.com/documentation/) and learn (but don't do) how to create those.
|
||||
If you said no to any of those...hop over to [docs](https://aws.amazon.com/documentation/) and learn (but don't do) how to create those.
|
||||
|
||||
|
||||
You will also need:
|
||||
@ -21,7 +21,7 @@ You will also need:
|
||||
|
||||
## Create Pre-requisites
|
||||
|
||||
First pick and AWS region and stick with it for ALL the quickstarts. This one was mostly executed on US-east-1/2 but any region with KMS, CodePipeline, and CodeBuild will work. Eu-Central-1, ap-southeast-1 and sa-east-1 have reported success also.
|
||||
First pick an AWS region and stick with it for ALL the quickstarts. This one was mostly executed on US-east-1/2 but any region with KMS, CodePipeline, and CodeBuild will work. eu-Central-1, ap-southeast-1 and sa-east-1 have reported success also.
|
||||
|
||||
|
||||
1. Create an S3 bucket and call it something meaningfull like `webgoat-stash-username` or something or use an existing bucket you have access to.
|
||||
@ -48,12 +48,12 @@ Some of the parameters you will need to pass:
|
||||
2. The Github Branch name (master? develop? yourbranchname?)
|
||||
3. The Github user (if you forked it would be your username)
|
||||
4. You personal access token for GitHub
|
||||
5. The name or the repo (WebGoat! ...unless you forked and rename and did a whole bunch of fancy git magic)
|
||||
5. The name or the repo (WebGoat! ...unless you renamed and did a whole bunch of fancy git magic)
|
||||
6. The ARN of the KMS key
|
||||
7. The ARN of the role for the codebuild (qsCodeRoleArn)
|
||||
8. The ARN for codepipeline (01_codepiplinebuild.yml)
|
||||
7. The ARN of the role for the codebuild for parameter qsCodeRoleArn
|
||||
8. The ARN for codepipeline
|
||||
|
||||
If this Stack successfully deploys a build will begin based on the lates commit automatically. You will have a funky named zip file (without the .zip) in a folder in the S3 bucket in a few minutes.
|
||||
If this Stack successfully deploys a build will begin based on the latest commit automatically. You will have a funky named zip file (without the .zip ending) in a folder in the S3 bucket in a few minutes.
|
||||
|
||||
|
||||
|
||||
|
||||
@ -1,25 +1,24 @@
|
||||
# GKE - DockerHub
|
||||
|
||||
This Quickstart shows how to create a Kubernettes Cluster using Google Cloud Platform's [GKE](https://cloud.google.com/container-engine/) and WebGoat Docker [Image](https://hub.docker.com/r/webgoat/webgoat-8.0/).
|
||||
This Quickstart shows how to create a Kubernettes Cluster using Google Cloud Platform's [GKE](https://cloud.google.com/container-engine/) and WebGoat's Docker [Image](https://hub.docker.com/r/webgoat/webgoat-8.0/).
|
||||
|
||||
To be Successfull with this Quickstart
|
||||
|
||||
1. You have a Google Cloud Platform account and have enough access rights to create Compute Engine and Container Engine Resources
|
||||
2. You know how to `git clone`
|
||||
3. You have access to the gcloud SDK
|
||||
3. You have the gcloud SDK install and initialized somewhere ( Or just use the Google Cloud Shell)
|
||||
|
||||
## Create Kubernettes Cluster
|
||||
|
||||
Using the cloud console the default settings will suffice. Just provide a cluster name that makes sense to you. Otherwise you can use the [Google Cloud Shell](https://cloud.google.com/shell/docs/) and the followihg command:
|
||||
Using the cloud console the default settings will suffice. The following is the commandline you would use to create the cluster using the gcloud command. For this QuickStart the cluster name used is `owaspbasiccluster`. The `PROJECTNAME` is whatever your project is. The `REGION` is a region near you.
|
||||
|
||||
|
||||
```
|
||||
gcloud container --project "PROJECTNAME" clusters create "owaspbasiccluster" --zone "us-central1-b" --machine-type "n1-standard-1" --image-type "COS" --disk-size "100" --scopes "https://www.googleapis.com/auth/compute","https://www.googleapis.com/auth/devstorage.read_only","https://www.googleapis.com/auth/logging.write","https://www.googleapis.com/auth/cloud-platform","https://www.googleapis.com/auth/servicecontrol","https://www.googleapis.com/auth/service.management.readonly","https://www.googleapis.com/auth/trace.append","https://www.googleapis.com/auth/source.read_only" --num-nodes "3" --network "default" --enable-cloud-logging --no-enable-cloud-monitoring
|
||||
gcloud container --project "PROJECTNAME" clusters create "owaspbasiccluster" --zone "REGION" --machine-type "n1-standard-1" --image-type "COS" --disk-size "100" --scopes "https://www.googleapis.com/auth/compute","https://www.googleapis.com/auth/devstorage.read_only","https://www.googleapis.com/auth/logging.write","https://www.googleapis.com/auth/cloud-platform","https://www.googleapis.com/auth/servicecontrol","https://www.googleapis.com/auth/service.management.readonly","https://www.googleapis.com/auth/trace.append","https://www.googleapis.com/auth/source.read_only" --num-nodes "3" --network "default" --enable-cloud-logging --no-enable-cloud-monitoring
|
||||
|
||||
|
||||
```
|
||||
|
||||
Notice that Google Source is `readonly` and Cloud Platform as `Enabled`
|
||||
|
||||
|
||||
## Set up Kubectl
|
||||
@ -30,7 +29,7 @@ If you have not already installed 'Kubectl' you can do so with the following com
|
||||
- `gcloud components install kubectl`
|
||||
|
||||
Then you just run:
|
||||
- `gcloud container clusters get-credentials owaspbasiccluster --zone us-central1-b --project PROJECTNAME`
|
||||
- `gcloud container clusters get-credentials owaspbasiccluster --zone REGION --project PROJECTNAME`
|
||||
|
||||
|
||||
## Deploy WebGoat Deployment
|
||||
|
||||
@ -5,7 +5,7 @@ This folder contains sub folders for the various ways you could deploy WebGoat o
|
||||
It is assumed:
|
||||
1. You have a Google Cloud Platform Account
|
||||
2. You can use Git
|
||||
3. You can use a Shell Linux/Mac/Google Cloud Shell
|
||||
3. You can use a Linux/Mac/Google Cloud Shell
|
||||
|
||||
|
||||
## GKE Docker
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user