Configuring access to a registry

1. View the list of available registries, their names and IDs:

   yc container registry list
   

   Result:

   +----------------------+--------+----------------------+
   |          ID          |  NAME  |      FOLDER ID       |
   +----------------------+--------+----------------------+
   | crpd50616s9a******** | my-reg | b1g88tflru0e******** |
   +----------------------+--------+----------------------+
   

2. Specify registry access settings:

   yc container registry set-ip-permissions <registry_name> \
     --pull <IP_address> \
     --push <IP_address>
   

   Where:

   • --pull: Flag that allows pulling Docker images from the registry.
   • --push: Flag that allows pushing Docker images to the registry.

   To learn more about the command, see the CLI reference.

   Running this command will remove all existing IP address permissions. To continue, type yes and press Enter.

   Result:

   WARN: All current ip permissions will be deleted. Are you sure?[y/N]
   

3. Check the applied restrictions:

   yc container registry list-ip-permissions <registry_name>
   

   Result:

   +--------+-----------+
   | ACTION |    IP     |
   +--------+-----------+
   | PULL   | 10.1.2.11 |
   | PUSH   | 10.1.2.11 |
   +--------+-----------+
   

With Terraform, you can quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. These files store the infrastructure description written in HashiCorp Configuration Language (HCL). If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

Terraform is distributed under the Business Source License. The Yandex Cloud provider for Terraform is distributed under the MPL-2.0 license.

For more information about the provider resources, see the guides on the Terraform website or its mirror.

If you do not have Terraform yet, install it and configure the Yandex Cloud provider.

To manage infrastructure using Terraform under a service account or user accounts (a Yandex account, a federated account, or a local user), authenticate using the appropriate method.

1. Specify registry access settings in the Terraform configuration file.

   resource "yandex_container_registry_ip_permission" "my_ip_permission" {
     registry_id = <registry_ID>
     push        = [ "<IP_address>", "<IP_address>" ]
     pull        = [ "<IP_address>", "<IP_address>" ]
   }
   

   Where:

   • my_registry: Registry ID. If the configuration already contains the yandex_container_registry resource, you can specify it, e.g., yandex_container_registry.my_registry.id.
   • pull: IP addresses that are allowed to pull Docker images from the registry. This is an optional setting.
   • push: IP addresses that are allowed to push Docker images to the registry. This is an optional setting.

   For more information about the yandex_container_registry_ip_permission properties in Terraform, see this provider guide.

2. Create the resources:

   1. In the terminal, navigate to the configuration file directory.

   2. Make sure the configuration is correct using this command:

      terraform validate
      

      If the configuration is valid, you will get this message:

      Success! The configuration is valid.
      

   3. Run this command:

      terraform plan
      

      You will see a list of resources and their properties. No changes will be made at this step. Terraform will show any errors in the configuration.

   4. Apply the configuration changes:

      terraform apply
      

   5. Type yes and press Enter to confirm the changes.

   Terraform will create all the required resources. You can check the new resources using the management console or this CLI command:

   yc container registry list-ip-permissions <registry_name>