1.72.0 • Published 4 years ago

@aws-solutions-constructs/aws-lambda-sagemaker v1.72.0

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
4 years ago

aws-lambda-sagemaker module


Stability: Experimental

All classes are under active development and subject to non-backward compatible changes or removal in any future version. These are not subject to the Semantic Versioning model. This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.


Reference Documentation:https://docs.aws.amazon.com/solutions/latest/constructs/
LanguagePackage
Python Logo Pythonaws_solutions_constructs.aws_lambda_sagemaker
Typescript Logo Typescript@aws-solutions-constructs/aws-lambda-sagemaker
Java Logo Javasoftware.amazon.awsconstructs.services.lambdasagemaker

This AWS Solutions Construct implements the AWS Lambda function and Amazon Sagemaker Notebook with the least privileged permissions.

Here is a minimal deployable pattern definition in Typescript:

import { LambdaToSagemakerProps,  LambdaToSagemaker } from '@aws-solutions-constructs/aws-lambda-sagemaker';
import { Aws } from "@aws-cdk/core";

const lambdaToSagemakerProps: LambdaToSagemakerProps = {
    lambdaFunctionProps: {
        code: lambda.Code.fromAsset(`${__dirname}/lambda`),
        runtime: lambda.Runtime.NODEJS_12_X,
        handler: 'index.handler'
    },
};

const construct = new LambdaToSagemaker(stack, 'test-lambda-sagemaker-stack', lambdaToSagemakerProps);

// // Add the necessary permissions to the SageMakerRole for accessing other AWS Resources e.g. S3 Bucket
// construct.sagemakerRole.addToPolicy(new iam.PolicyStatement({
//     resources: [`arn:${Aws.PARTITION}:s3:::<Your bucket name>/*`],
//     actions: [
//         "s3:GetObject*",
//         "s3:PutObject*",
//     ],
// }));

// // Add the necessary permissions to the Lambda Function Role e.g. additional SageMaker permissions
// construct.lambdaFunction.role?.addToPrincipalPolicy(new iam.PolicyStatement({
//     resources: [`arn:${Aws.PARTITION}:sagemaker:${Aws.REGION}:${Aws.ACCOUNT_ID}:transform-job/*`],
//     actions: [
//         "sagemaker:CreateTransformJob",
//     ],
// }));

Initializer

new LambdaToSagemaker(scope: Construct, id: string, props: LambdaToSagemakerProps);

Parameters

Pattern Construct Props

NameTypeDescription
existingLambdaObj?lambda.FunctionExisting instance of Lambda Function object, if this is set then the lambdaFunctionProps is ignored.
lambdaFunctionProps?lambda.FunctionPropsUser provided props to override the default props for the Lambda function.
sagemakerNotebookProps?sagemaker.CfnNotebookInstancePropsOptional user provided props to override the default props for a Sagemaker Notebook.
deployInsideVpc?booleanOptional user provided props to deploy inside vpc. Defaults to true.
existingNotebookObj?sagemaker.CfnNotebookInstancePropsExisting instance of notebook object. If this is set then the sagemakerNotebookProps is ignored

Pattern Properties

NameTypeDescription
lambdaFunctionlambda.FunctionReturns an instance of lambda.Function created by the construct
sagemakerNotebooksagemaker.CfnNotebookInstancePropsReturns an instance of sagemaker.CfnNotebookInstanceProps created by the construct
sagemakerRoleiam.RoleReturns the iam.Role created by the construct
vpc?ec2.VpcReturns the ec2.Vpc created by the construct
securityGroup?ec2.SecurityGroupReturns the ec2.SecurityGroup created by the construct

Default settings

Out of the box implementation of the Construct without any override will set the following defaults:

AWS Lambda Function

  • Configure limited privilege access IAM role for Lambda function
  • Enable reusing connections with Keep-Alive for NodeJs Lambda function

Amazon SageMaker

  • Configure least privilege access IAM role for the SageMaker Notebook Intance
  • Deploy SageMaker NotebookInstance inside the VPC
  • Enable server-side encryption for the SageMaker NotebookInstance using Customer Managed KMS Key

Architecture

Architecture Diagram


© Copyright 2020 Amazon.com, Inc. or its affiliates. All Rights Reserved.