def get(self, _req, **_):
"""
@api {get} /registry/ Get Repository list
@apiName GetRepositories
@apiGroup RegistryManager
@apiVersion 0.1.0
@apiPermission admin
@apiSuccess {Object} payload Response Object
@apiSuccess {Number} payload.count Count of total repositories
@apiSuccess {Object[]} payload.entry List of Repositoris
@apiSuccess {String} payload.entry.Repo Repository Name
@apiUse APIHeader
@apiUse Success
@apiUse OperationFailed
@apiUse Unauthorized
"""
response = RESPONSE.SUCCESS
try:
response['payload']['entity'] = []
dxfbase = DXFBase(REGISTRY_ADDRESS)
for repository in dxfbase.list_repos():
response['payload']['entity'].append(
self.util.get_repository(repository))
response['payload']['count'] = len(response['payload']['entity'])
return JsonResponse(response)
except Exception as ex:
LOGGER.exception(ex)
return JsonResponse(RESPONSE.OPERATION_FAILED)
def __init__(self, host, auth=None, insecure=False, auth_host=None):
"""
:param host: Host name of registry. Can contain port numbers. e.g. ``registry-1.docker.io``, ``localhost:5000``.
:type host: str
:param auth: Authentication function to be called whenever authentication to the registry is required. Receives the :class:`DTufBase` object and a HTTP response object. It should call :meth:`authenticate` on ``dtuf_obj`` with a username, password and ``response`` before it returns.
:type auth: function(dtuf_obj, response)
:param insecure: Use HTTP instead of HTTPS (which is the default) when connecting to the registry.
:type insecure: bool
:param auth_host: Host to use for token authentication. If set, overrides host returned by then registry.
:type auth_host: str
"""
self._dxf = DXFBase(host, self._wrap_auth(auth), insecure, auth_host)
def __init__(self, host, auth=None, insecure=False, auth_host=None):
"""
:param host: Host name of registry. Can contain port numbers. e.g. ``registry-1.docker.io``, ``localhost:5000``.
:type host: str
:param auth: Authentication function to be called whenever authentication to the registry is required. Receives the :class:`DTufBase` object and a HTTP response object. It should call :meth:`authenticate` on ``dtuf_obj`` with a username, password and ``response`` before it returns.
:type auth: function(dtuf_obj, response)
:param insecure: Use HTTP instead of HTTPS (which is the default) when connecting to the registry.
:type insecure: bool
:param auth_host: Host to use for token authentication. If set, overrides host returned by then registry.
:type auth_host: str
"""
self._dxf = DXFBase(host, self._wrap_auth(auth), insecure, auth_host)
parser.add_argument('-f',
'--from',
required=True,
type=address_with_credentials,
dest='source')
parser.add_argument('-t',
'--to',
required=True,
type=address_with_credentials,
dest='destination')
parser.add_argument('-i', '--insecure', action='store_false', dest='tlsverify')
parser.set_defaults(tlsverify=True)
args = parser.parse_args()
source = DXFBase(args.source.address,
auth=args.source.auth,
tlsverify=args.tlsverify)
source_repositories = source.list_repos()
destination = DXFBase(args.destination.address,
auth=args.destination.auth,
tlsverify=args.tlsverify)
destination_repositories = destination.list_repos()
for repository in source_repositories:
source_repository = DXF.from_base(source, repository)
destination_repository = DXF.from_base(destination, repository)
try:
tags = source_repository.list_aliases()
except DXFUnauthorizedError:
print(
class DTufBase(object):
"""
Class for communicating with a Docker v2 registry.
Contains only operations which aren't related to pushing and pulling data
to repositories in the registry using
`The Update Framework <https://github.com/theupdateframework/tuf>`_.
Can act as a context manager. For each context entered, a new
`requests.Session <http://docs.python-requests.org/en/latest/user/advanced/#session-objects>`_
is obtained. Connections to the same host are shared by the session.
When the context exits, all the session's connections are closed.
If you don't use :class:`DTufBase` as a context manager, each request
uses an ephemeral session. If you don't read all the data from an iterator
returned by :meth:`DTufCopy.pull_target` then the underlying connection
won't be closed until Python garbage collects the iterator.
"""
def __init__(self, host, auth=None, insecure=False, auth_host=None):
"""
:param host: Host name of registry. Can contain port numbers. e.g. ``registry-1.docker.io``, ``localhost:5000``.
:type host: str
:param auth: Authentication function to be called whenever authentication to the registry is required. Receives the :class:`DTufBase` object and a HTTP response object. It should call :meth:`authenticate` on ``dtuf_obj`` with a username, password and ``response`` before it returns.
:type auth: function(dtuf_obj, response)
:param insecure: Use HTTP instead of HTTPS (which is the default) when connecting to the registry.
:type insecure: bool
:param auth_host: Host to use for token authentication. If set, overrides host returned by then registry.
:type auth_host: str
"""
self._dxf = DXFBase(host, self._wrap_auth(auth), insecure, auth_host)
def _wrap_auth(self, auth=None):
return lambda dxf_obj, response: auth(self, response) if auth else None
@property
def token(self):
"""
str: Authentication token. This will be obtained automatically when
you call :meth:`authenticate`. If you've obtained a token
previously, you can also set it but be aware tokens expire quickly.
"""
return self._dxf.token
@token.setter
def token(self, value):
self._dxf.token = value
def authenticate(self,
username=None,
password=None,
actions=None,
response=None):
"""
Authenticate to the registry, using a username and password if supplied,
otherwise as the anonymous user.
:param username: User name to authenticate as.
:type username: str
:param password: User's password.
:type password: str
:param actions: If you know which types of operation you need to make on the registry, specify them here. Valid actions are ``pull``, ``push`` and ``*``.
:type actions: list
:param response: When the ``auth`` function you passed to :class:`DTufBase`'s constructor is called, it is passed a HTTP response object. Pass it back to :meth:`authenticate` to have it automatically detect which actions are required.
:type response: requests.Response
:rtype: str
:returns: Authentication token, if the registry supports bearer tokens. Otherwise ``None``, and HTTP Basic auth is used.
"""
return self._dxf.authenticate(username, password, actions, response)
def list_repos(self):
"""
List all repositories in the registry.
:rtype: list
:returns: List of repository names.
"""
return self._dxf.list_repos()
def __enter__(self):
self._dxf.__enter__()
return self
def __exit__(self, *args):
return self._dxf.__exit__(*args)
class DTufBase(object):
"""
Class for communicating with a Docker v2 registry.
Contains only operations which aren't related to pushing and pulling data
to repositories in the registry using
`The Update Framework <https://github.com/theupdateframework/tuf>`_.
Can act as a context manager. For each context entered, a new
`requests.Session <http://docs.python-requests.org/en/latest/user/advanced/#session-objects>`_
is obtained. Connections to the same host are shared by the session.
When the context exits, all the session's connections are closed.
If you don't use :class:`DTufBase` as a context manager, each request
uses an ephemeral session. If you don't read all the data from an iterator
returned by :meth:`DTufCopy.pull_target` then the underlying connection
won't be closed until Python garbage collects the iterator.
"""
def __init__(self, host, auth=None, insecure=False, auth_host=None):
"""
:param host: Host name of registry. Can contain port numbers. e.g. ``registry-1.docker.io``, ``localhost:5000``.
:type host: str
:param auth: Authentication function to be called whenever authentication to the registry is required. Receives the :class:`DTufBase` object and a HTTP response object. It should call :meth:`authenticate` on ``dtuf_obj`` with a username, password and ``response`` before it returns.
:type auth: function(dtuf_obj, response)
:param insecure: Use HTTP instead of HTTPS (which is the default) when connecting to the registry.
:type insecure: bool
:param auth_host: Host to use for token authentication. If set, overrides host returned by then registry.
:type auth_host: str
"""
self._dxf = DXFBase(host, self._wrap_auth(auth), insecure, auth_host)
def _wrap_auth(self, auth=None):
return lambda dxf_obj, response: auth(self, response) if auth else None
@property
def token(self):
"""
str: Authentication token. This will be obtained automatically when
you call :meth:`authenticate`. If you've obtained a token
previously, you can also set it but be aware tokens expire quickly.
"""
return self._dxf.token
@token.setter
def token(self, value):
self._dxf.token = value
def authenticate(self,
username=None, password=None,
actions=None, response=None):
"""
Authenticate to the registry, using a username and password if supplied,
otherwise as the anonymous user.
:param username: User name to authenticate as.
:type username: str
:param password: User's password.
:type password: str
:param actions: If you know which types of operation you need to make on the registry, specify them here. Valid actions are ``pull``, ``push`` and ``*``.
:type actions: list
:param response: When the ``auth`` function you passed to :class:`DTufBase`'s constructor is called, it is passed a HTTP response object. Pass it back to :meth:`authenticate` to have it automatically detect which actions are required.
:type response: requests.Response
:rtype: str
:returns: Authentication token, if the registry supports bearer tokens. Otherwise ``None``, and HTTP Basic auth is used.
"""
return self._dxf.authenticate(username, password, actions, response)
def list_repos(self):
"""
List all repositories in the registry.
:rtype: list
:returns: List of repository names.
"""
return self._dxf.list_repos()
def __enter__(self):
self._dxf.__enter__()
return self
def __exit__(self, *args):
return self._dxf.__exit__(*args)