IBM Container Registry module

You can use this module to provision and configure an IBM Container Registry namespace and optionally, a container registry retention policy.

Overview

• terraform-ibm-container-registry
• Submodules
  • plan
• Examples
  • IBM Container Registry namespace example
• Contributing

terraform-ibm-container-registry

Usage

module "namespace" {
  source            = "terraform-ibm-modules/container-registry/ibm"
  version           = "X.X.X" # Replace "X.X.X" with a release version to lock into a specific release
  name              = "my-namespace"
  resource_group_id = "xxXXxxXXxXxXXXXxxXxxxXXXXxXXXXX"
  images_per_repo   = 2
}

Required IAM access policies

• Account Management
  • IBM Cloud Container Registry service
    • Writer, Manager service access

Access roles for using Container Registry

Requirements

Name	Version
terraform	>= 1.3.0
ibm	>= 1.49.0, < 2.0.0

Modules

No modules.

Resources

Name	Type
ibm_cr_namespace.cr_namespace	resource
ibm_cr_retention_policy.cr_retention_policy	resource

Inputs

Name	Description	Type	Default	Required
images_per_repo	(Optional, Integer) Determines how many images are retained in each repository when the retention policy is processed. The value -1 denotes Unlimited (all images are retained). The value 0 denotes no retention policy will be created (default)	number	0	no
name	Name of the container registry namespace	string	n/a	yes
resource_group_id	The resource group ID where the IBM container namespace will be created.	string	n/a	yes
retain_untagged	(Optional, Bool) Determines whether untagged images are retained when the retention policy is processed. Default value is false, means untagged images can be deleted when the policy runs.	bool	false	no
tags	Optional list of tags to be added to the IBM container namespace.	list(string)	[]	no

Outputs

Name	Description
namespace_crn	CRN representing the namespace

Contributing

You can report issues and request features for this module in GitHub issues in the module repo. See Report an issue or request a feature.

To set up your local development environment, see Local development setup in the project documentation.