create registry

# iagctl create registry

Create a new dependency management registry

Synopsis

This command creates a registry reference in your gateway's data store. You can create registries that point to private PyPI and Ansible Galaxy registries for use with your Python and Ansible services.

By default, IAG includes a PyPI registry reference called default-pypi that points to the public PyPI registry and an Ansible Galaxy registry reference called default-galaxy that points to the public Ansible Galaxy registry. For more information, see

Handle secret values

Use the --password-name and --token-name flags to reference the names of secret resources that contain the actual password or token value. This ensures that IAG doesn't store the actual password or token value in plain text in the registry resource itself.

For example, to create a registry that requires a token:

1. Set up a secret store with an encryption file.
2. Create a secret that contains the token value:

   iagctl create secret my-pypi-token --value 'my-token-value'
   

3. Create the registry with the --token-name flag:

   iagctl create registry pypi my-pypi-registry --url 'http://private-repo-hostname' --token-name my-pypi-token
   

4. The registry my-pypi-registry now references the secret my-pypi-token for its token value. IAG decrypts the token value at runtime when you execute a service that requires the registry.

For more information about creating secret resources, see iagctl create secret.

Examples

Create a PyPI registry

The following example creates a basic PyPI registry called my-pypi-registry

iagctl create registry pypi my-pypi-registry \
--url 'http://repo-hostname:8080/simple'

Create an Ansible Galaxy registry

The following example creates a basic Ansible Galaxy registry called my-galaxy-registry.

iagctl create registry ansible-galaxy my-galaxy-registry \
--url 'http://repo-hostname:8080'

Options

  -h, --help   help for registry

Options inherited from parent commands

      --config string   Path to the configuration file
      --raw             Displays the result of the command in its raw format
      --verbose         Enable verbose output

Learn more

• Dependency registries
• iagctl create - Create a resource
• iagctl create registry ansible-galaxy - Create a new ansible-galaxy registry
• iagctl create registry pypi - Create a new pypi registry