Establish access and permissions for Git-based repositories - Amazon EMR

Establish access and permissions for Git-based repositories

EMR Studio supports the following Git-based services:

To let your EMR Studio users associate a Git repository with a Workspace, set up the following access and permissions requirements. You can also configure Git-based repositories that you host in a private network by following the instructions in Configure a privately-hosted Git repository for EMR Studio.

Cluster internet access

Both Amazon EMR clusters running on Amazon EC2 and Amazon EMR on EKS clusters attached to Studio Workspaces must be in a private subnet that uses a network address translation (NAT) gateway, or they must be able to access the internet through a virtual private gateway. For more information, see Amazon VPC options.

The security groups that you use with EMR Studio must also include an outbound rule that allows Workspaces to route traffic to the internet from an attached EMR cluster. For more information, see Define security groups to control EMR Studio network traffic.


If the network interface is launched into a public subnet, it won't be able to communicate with the internet through an internet gateway (IGW).

Permissions for AWS Secrets Manager

To let EMR Studio users access Git repositories with secrets stored in AWS Secrets Manager, add a permissions policy to the service role for EMR Studio that allows the secretsmanager:GetSecretValue action.

For information about how to link Git-based repositories to Workspaces, see Link Git-based repositories to an EMR Studio Workspace.

Configure a privately-hosted Git repository for EMR Studio

Use the following instructions to configure privately-hosted repositories for Amazon EMR Studio. You must provide a configuration file with information about your DNS and Git servers. EMR Studio uses this information to configure Workspaces that can route traffic to your self-managed repositories.


Before you configure a privately-hosted Git repository for EMR Studio, you must have the following:

  • A designated Amazon S3 Control storage bucket where EMR Studio can back up the Workspaces and notebook files in your Studio. Use the same S3 bucket that you specify when you create a Studio.

To configure one or more privately-hosted Git repositories for EMR Studio

  1. Create a configuration file using the provided template. Include the following values for each Git server that you want to specify in your configuration:

    • DnsServerIpV4 - The IPv4 address of your DNS server. If you provide values for both DnsServerIpV4 and GitServerIpV4List, the value for DnsServerIpV4 takes precedence and will be used to resolve your GitServerDnsName.


      To use privately-hosted Git repositories, your DNS server must allow inbound access from EMR Studio. We strongly recommend that you secure your DNS server against other, unauthorized access.

    • GitServerDnsName - The DNS name of your Git server. For example "".

    • GitServerIpV4List - A list of IPv4 addresses that belong to your Git servers.

    [ { "Type": "PrivatelyHostedGitConfig", "Value": [ { "DnsServerIpV4": "<>", "GitServerDnsName": "<>", "GitServerIpV4List": [ "<>", "<>" ] }, { "DnsServerIpV4": "<>", "GitServerDnsName": "<>", "GitServerIpV4List": [ "<>", "<>" ] } ] } ]
  2. Save your configuration file as configuration.json.

  3. Upload the configuration file into your designated Amazon S3 storage location in a folder called life-cycle-configuration. For example, if your default S3 location is s3://DOC-EXAMPLE-BUCKET/studios, your configuration file should be located at s3://DOC-EXAMPLE-BUCKET/studios/life-cycle-configuration/configuration.json.


    We strongly recommend that you restrict access to your life-cycle-configuration folder to only Studio administrators and to your EMR Studio service role, and that you secure configuration.json against unauthorized access. For instructions, see Controlling access to a bucket with user policies or Security Best Practices for Amazon S3.

    For upload instructions, see Creating a folder and Uploading objects in the Amazon Simple Storage Service User Guide. To apply your configuration to existing Workspaces, you should close and restart any open Workspaces after you upload your configuration file to Amazon S3.