docs: installation, CARM, CRM and adopted resource (#35)

Author: surajkota

README.md

@@ -4,10 +4,23 @@ This sample demonstrates how to start jobs using your own script, packaged in a
 
 ## Prerequisites    
 
-This sample assumes that you have already configured an Kubernetes cluster with the ACK operator. It also assumes that you have installed `kubectl` - you can find a link on our [installation page](To do).
+Follow the instructions on our [installation page](/README.md#getting-started) to create a Kubernetes cluster and install sagemaker controller.
 
-You will also need an IAM role which has permissions to access your S3 resources and SageMaker. If you have not yet created a role with these permissions, you can find an example policy at [Amazon SageMaker Roles](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-roles.html#sagemaker-roles-createtrainingjob-perms).
+Run the following commands to create a SageMaker execution IAM role which is used by SageMaker service to access AWS resources. 
 
+```
+export SAGEMAKER_EXECUTION_ROLE_NAME=ack-sagemaker-execution-role-$CLUSTER_NAME
+
+TRUST="{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Principal\": { \"Service\": \"sagemaker.amazonaws.com\" }, \"Action\": \"sts:AssumeRole\" } ] }"
+aws iam create-role --role-name ${SAGEMAKER_EXECUTION_ROLE_NAME} --assume-role-policy-document "$TRUST"
+aws iam attach-role-policy --role-name ${SAGEMAKER_EXECUTION_ROLE_NAME} --policy-arn arn:aws:iam::aws:policy/AmazonSageMakerFullAccess
+aws iam attach-role-policy --role-name ${SAGEMAKER_EXECUTION_ROLE_NAME} --policy-arn arn:aws:iam::aws:policy/AmazonS3FullAccess
+
+SAGEMAKER_EXECUTION_ROLE_ARN=$(aws iam get-role --role-name ${SAGEMAKER_EXECUTION_ROLE_NAME} --output text --query 'Role.Arn')
+
+echo $SAGEMAKER_EXECUTION_ROLE_ARN
+```
+Note down the execution role ARN to use in samples
 ### Creating your first Job
 
 The easiest way to start is taking a look at the sample training jobs and its corresponding [README](/samples/training/README.md)

samples/README.md

@@ -4,7 +4,7 @@ This sample demonstrates how to start batch transform jobs using your own batch-
 
 ## Prerequisites
 
-This sample assumes that you have already configured an Kubernetes cluster with the ACK operator. It also assumes that you have installed `kubectl` - you can find a link on our [installation page](To do).
+This sample assumes that you have completed the [common prerequisties](/samples/README.md).
 
 You will also need a model in SageMaker for this sample. If you do not have one you must first create a [model](/samples/model/README.md).
 

samples/batch_transform/README.md

@@ -4,7 +4,7 @@ This sample demonstrates how to create Endpoints using your own Endpoint_base/co
 
 ## Prerequisites
 
-This sample assumes that you have already configured an Kubernetes cluster with the ACK operator. It also assumes that you have installed `kubectl` - you can find a link on our [installation page](To do).
+This sample assumes that you have completed the [common prerequisties](/samples/README.md).
 
 You will also need a model in SageMaker for this sample. If you do not have one you must first create a [model](/samples/model/README.md)
 

samples/endpoint/README.md

@@ -4,9 +4,7 @@ This sample demonstrates how to start hyperparameter jobs using your own hyperpa
 
 ## Prerequisites
 
-This sample assumes that you have already configured an Kubernetes cluster with the ACK operator. It also assumes that you have installed `kubectl` - you can find a link on our [installation page](To do).
-
-In order to follow this script, you must first create a hyperparameter script packaged in a Dockerfile that is [compatible with Amazon SageMaker](https://docs.aws.amazon.com/sagemaker/latest/dg/amazon-sagemaker-containers.html). Here is a list of available [containers](https://github.com/aws/deep-learning-containers/blob/master/available_images.md)
+This sample assumes that you have completed the [common prerequisties](/samples/README.md).
 
 ### Get an Image
 

samples/hyperparameter_tuning/README.md

@@ -4,7 +4,7 @@ This sample demonstrates how to start data quality job definitions using your ow
 
 ## Prerequisites
 
-This sample assumes that you have already configured an Kubernetes cluster with the ACK operator. It also assumes that you have installed `kubectl` - you can find a link on our [installation page](To do).
+This sample assumes that you have completed the [common prerequisties](/samples/README.md).
 
 You will need an [Endpoint](/samples/endpoint/README.md) configured in SageMaker and you will need to run a baselining job to generate baseline statistics and constraints.
 

samples/job_definitions/data_quality/README.md

@@ -4,7 +4,7 @@ This sample demonstrates how to start model-bias job definitions using your own
 
 ## Prerequisites
 
-This sample assumes that you have already configured an Kubernetes cluster with the ACK operator. It also assumes that you have installed `kubectl` - you can find a link on our [installation page](To do).
+This sample assumes that you have completed the [common prerequisties](/samples/README.md).
 
 You will also need an [Endpoint](/samples/endpoint/README.md) configured in SageMaker and you will need to run a baselining job to generate baseline constraints only.
 

samples/job_definitions/model_bias/README.md

@@ -4,7 +4,7 @@ This sample demonstrates how to start model-explainability job definitions using
 
 ## Prerequisites
 
-This sample assumes that you have already configured an Kubernetes cluster with the ACK operator. It also assumes that you have installed `kubectl` - you can find a link on our [installation page](To do).
+This sample assumes that you have completed the [common prerequisties](/samples/README.md).
 
 You will also need an [Endpoint](/samples/endpoint/README.md) configured in SageMaker and you will need to run a baselining job to generate baseline constraints only.
 

samples/job_definitions/model_explainability/README.md

@@ -4,7 +4,7 @@ This sample demonstrates how to start model-quality job definitions using your o
 
 ## Prerequisites
 
-This sample assumes that you have already configured an Kubernetes cluster with the ACK operator. It also assumes that you have installed `kubectl` - you can find a link on our [installation page](To do).
+This sample assumes that you have completed the [common prerequisties](/samples/README.md).
 
 You will also need an [Endpoint](/samples/endpoint/README.md) configured in SageMaker and you will need to run a baselining job to generate baseline constraints only.
 

samples/job_definitions/model_quality/README.md

@@ -4,7 +4,7 @@ This sample demonstrates how to start models/create a model using your own model
 
 ## Prerequisites
 
-This sample assumes that you have already configured an Kubernetes cluster with the ACK operator. It also assumes that you have installed `kubectl` - you can find a link on our [installation page](To do).
+This sample assumes that you have completed the [common prerequisties](/samples/README.md).
 
 ### Get an Image