Buckets:

hf-doc-build
/

doc-dev

Files

xet

hf-doc-build/doc-dev / inference-endpoints /pr_137 /en /guides /private_link.html

rtrm

4 months ago

download

raw

16.4 kB

	<meta charset="utf-8" /><meta name="hf:doc:metadata" content="{"title":"Create a Private Endpoint with AWS PrivateLink","local":"create-a-private-endpoint-with-aws-privatelink","sections":[{"title":"Configuring the AWS Private Link","local":"configuring-the-aws-private-link","sections":[{"title":"1. Select Private Endpoint Security Level","local":"1-select-private-endpoint-security-level","sections":[],"depth":3},{"title":"2. Create the Endpoint","local":"2-create-the-endpoint","sections":[],"depth":3},{"title":"3. Connect your VPC to your Interface Endpoint","local":"3-connect-your-vpc-to-your-interface-endpoint","sections":[],"depth":3},{"title":"4. Ready to Connect","local":"4-ready-to-connect","sections":[],"depth":3}],"depth":2},{"title":"Shared Private Services","local":"shared-private-services","sections":[],"depth":2}],"depth":1}">
	<link href="/docs/inference-endpoints/pr_137/en/_app/immutable/assets/0.e3b0c442.css" rel="modulepreload">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/entry/start.3a105e93.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/chunks/scheduler.f6b352c8.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/chunks/singletons.a98789aa.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/chunks/index.26cf6c5a.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/chunks/paths.9b3b514b.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/entry/app.ab856995.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/chunks/index.b90df637.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/nodes/0.7555fdf3.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/chunks/each.e59479a4.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/nodes/16.6cfa5653.js">
	<link rel="modulepreload" href="/docs/inference-endpoints/pr_137/en/_app/immutable/chunks/getInferenceSnippets.1e3ae0bf.js"><!-- HEAD_svelte-u9bgzb_START --><meta name="hf:doc:metadata" content="{"title":"Create a Private Endpoint with AWS PrivateLink","local":"create-a-private-endpoint-with-aws-privatelink","sections":[{"title":"Configuring the AWS Private Link","local":"configuring-the-aws-private-link","sections":[{"title":"1. Select Private Endpoint Security Level","local":"1-select-private-endpoint-security-level","sections":[],"depth":3},{"title":"2. Create the Endpoint","local":"2-create-the-endpoint","sections":[],"depth":3},{"title":"3. Connect your VPC to your Interface Endpoint","local":"3-connect-your-vpc-to-your-interface-endpoint","sections":[],"depth":3},{"title":"4. Ready to Connect","local":"4-ready-to-connect","sections":[],"depth":3}],"depth":2},{"title":"Shared Private Services","local":"shared-private-services","sections":[],"depth":2}],"depth":1}"><!-- HEAD_svelte-u9bgzb_END --> <p></p> <h1 class="relative group"><a id="create-a-private-endpoint-with-aws-privatelink" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#create-a-private-endpoint-with-aws-privatelink"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>Create a Private Endpoint with AWS PrivateLink</span></h1> <p data-svelte-h="svelte-1qcrs7j">AWS PrivateLink enables you to privately connect your VPC to your Inference Endpoints, without exposing your traffic to the public
	internet. It uses private IP addresses to route traffic between your VPC and the service, ensuring that data never traverses the
	public internet, providing enhanced security and compliance benefits.</p> <p data-svelte-h="svelte-1cs38en">To create a Private Endpoint, you’ll need to connect the AWS Account using the account ID. The following guide will walk you
	through how to set it up.</p> <h2 class="relative group"><a id="configuring-the-aws-private-link" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#configuring-the-aws-private-link"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>Configuring the AWS Private Link</span></h2> <h3 class="relative group"><a id="1-select-private-endpoint-security-level" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#1-select-private-endpoint-security-level"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>1. Select Private Endpoint Security Level</span></h3> <p data-svelte-h="svelte-l0rs6d">Choose the “Private” option to ensure the endpoint is only available through an intra-region secured AWS PrivateLink connection.
	Enable PrivateLink sharing if you want the PrivateLink to be shared between several endpoints.
	This connects one or more endpoints to the same VPC Endpoint.</p> <p data-svelte-h="svelte-paovs7"><img src="https://raw.githubusercontent.com/huggingface/hf-endpoints-documentation/main/assets/6_private_type.png" alt="select private link"></p> <h3 class="relative group"><a id="2-create-the-endpoint" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#2-create-the-endpoint"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>2. Create the Endpoint</span></h3> <p data-svelte-h="svelte-pni4rq">After providing your AWS Account ID and any other required information, click Create Endpoint. The endpoint creation process will begin.</p> <p data-svelte-h="svelte-em1fkm"><img src="https://raw.githubusercontent.com/huggingface/hf-endpoints-documentation/main/assets/6_2_endpoint_creation.png" alt="creation process"></p> <p data-svelte-h="svelte-18ow0or">After a few minutes, the endpoint will be created, and you will see the VPC Service Name in the overview. This name is necessary for
	creating the VPC Interface Endpoint in your AWS account.</p> <p data-svelte-h="svelte-wr1qe4"><img src="https://raw.githubusercontent.com/huggingface/hf-endpoints-documentation/main/assets/6_3_vpc_ready.png" alt="vpc service name"></p> <h3 class="relative group"><a id="3-connect-your-vpc-to-your-interface-endpoint" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#3-connect-your-vpc-to-your-interface-endpoint"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>3. Connect your VPC to your Interface Endpoint</span></h3> <p data-svelte-h="svelte-1t5q07m">Go to your AWS <a href="https://console.aws.amazon.com/vpc/home?#Endpoints" rel="nofollow">console</a> and navigate to the VPC section to create the VPC Interface
	Endpoint. Select “Other endpoint services” and enter the VPC Service Name provided earlier.</p> <p data-svelte-h="svelte-1cek4vb"><img src="https://raw.githubusercontent.com/huggingface/hf-endpoints-documentation/main/assets/6_4_add_private_link.png" alt="add private link"></p> <p data-svelte-h="svelte-1i5yh77">Verify the service name to ensure the connection is correct. Choose the VPC and subnets you wish to use for this endpoint. Make sure
	they align with your security requirements.</p> <p data-svelte-h="svelte-1win90d"><img src="https://raw.githubusercontent.com/huggingface/hf-endpoints-documentation/main/assets/6_5_add_vpc.png" alt="vpc endpoint"></p> <h3 class="relative group"><a id="4-ready-to-connect" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#4-ready-to-connect"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>4. Ready to Connect</span></h3> <p data-svelte-h="svelte-vkc6rd">After the VPC Endpoint status changes from pending to available, you should see an Endpoint URL in the overview. This URL can now
	be used inside your VPC to access your endpoint in a secure and protected way, ensuring traffic is only occurring between the two
	endpoints and will never leave AWS.</p> <p data-svelte-h="svelte-19i8gjy"><img src="https://raw.githubusercontent.com/huggingface/hf-endpoints-documentation/main/assets/6_6_running_endpoint.png" alt="endpoint running"></p> <h2 class="relative group"><a id="shared-private-services" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#shared-private-services"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>Shared Private Services</span></h2> <p data-svelte-h="svelte-7clqqb">If you have enabled the PrivateLink sharing option, you can now create additional endpoints that share the same VPC Endpoint. This
	allows you to connect multiple endpoints to the same VPC Endpoint.</p> <p data-svelte-h="svelte-1fgk5o5"><img src="https://raw.githubusercontent.com/huggingface/hf-endpoints-documentation/main/assets/6_7_private_service_tooltip.png" alt="shared private link"></p> <a class="!text-gray-400 !no-underline text-sm flex items-center not-prose mt-4" href="https://github.com/huggingface/hf-endpoints-documentation/blob/main/docs/source/guides/private_link.mdx" target="_blank"><span data-svelte-h="svelte-1kd6by1"><</span> <span data-svelte-h="svelte-x0xyl0">></span> <span data-svelte-h="svelte-1dajgef"><span class="underline ml-1.5">Update</span> on GitHub</span></a> <p></p>

	<script>
	{
	__sveltekit_zqvze9 = {
	assets: "/docs/inference-endpoints/pr_137/en",
	base: "/docs/inference-endpoints/pr_137/en",
	env: {}
	};

	const element = document.currentScript.parentElement;

	const data = [null,null];

	Promise.all([
	import("/docs/inference-endpoints/pr_137/en/_app/immutable/entry/start.3a105e93.js"),
	import("/docs/inference-endpoints/pr_137/en/_app/immutable/entry/app.ab856995.js")
	]).then(([kit, app]) => {
	kit.start(app, element, {
	node_ids: [0, 16],
	data,
	form: null,
	error: null
	});
	});
	}
	</script>

Xet Storage Details

Size:: 16.4 kB
Xet hash:: 59216e2a22b3056e3039d35b847571dfea304193bb136524d05a037e202115b6

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.