Skip to content

Latest commit

 

History

History
102 lines (78 loc) · 5.09 KB

README.md

File metadata and controls

102 lines (78 loc) · 5.09 KB

Warning

This page is no longer being maintained and will be archived by Tuesday, November 11, 2023. Please visit aka.ms/acr/artifact-streaming.

Project Teleport Overview (Private Preview)

Instancing a custom environment within seconds is one of the many wonders of running containers. Having to wait for the image and its layers to download & decompress the first time is the current price of admission.

Project Teleport removes the cost of download and decompression by mounting pre-expanded layers from the Azure Container Registry to Teleport enabled Azure container hosts.

Dedicated VM Teleport w/ACR Tasks

For more background, please see Azure Container Registry Adds Teleportation

Table of Contents

Sign Up for the Project Teleport Preview

In these early stages, we're looking for direct feedback. To request access, please sign up here: aka.ms/teleport/signup

Supported Services

Additional services and scenarios will come online as we incorporate more feedback.

Preview Constraints

Preview 2 has the following constraints. Your feedback will help us prioritize this list.

  • 10 Repository limit. More info: teleport-repository-management
  • Limited to running images with AKS
  • Support for premium registries
  • Registries must exist in the following regions:
    Region Code
    East US EUS
    East US 2 EUS2
    South Central US SCUS
    West US WUS
    West US 2 WUS2
    West Europe WEU
    • Additional regions, including other continents will come online as we get more feedback.
  • Geo-replication: Geo-replicated registries are not currently supported.
  • Linux images are currently supported with Windows images coming in a future release.
  • ACR Webhook Push notifications occur when the image manifest and compressed blobs are completed. However, layer expansion will take several additional seconds, depending on the size and quantity of layers. We are considering various options when layer expansion has completed within each region, including regionalized layer-expanded notifications and enhancements to az acr repository show. For now, a check-expansion.sh script is provided.

Getting Support

How Do I...

  • Q: run some baseline Project Teleport examples

  • Q: know when an image is expanded, and ready for teleportation?

    • A: ACR will support a new notification event, as well as CLI support. For Preview 2, you can run the following script, passing in 3 arguments for each image you'd like to check, with credentials saved to environment variables.
    ./check-expansion.sh [registryName] [repoName] [tag] [optional: --debug]
./check-expansion.sh demo42t hello-world 1.0 --debug

  • Q: know if a repository is enabled for teleportation?

    • A: Project Teleport must be enabled by the ACR Product team. To verify a repository is enabled, use az acr repository show, looking for the teleportEnabled attribute.
    az acr repository show \
  --repository azure-vote-front \
  -o jsonc
{
"changeableAttributes": {
  "deleteEnabled": true,
  "listEnabled": true,
  "readEnabled": true,
  "teleportEnabled": true,
  "writeEnabled": true