2018-04-24 11:54:07 +00:00
|
|
|
import json
|
|
|
|
|
|
|
|
from cStringIO import StringIO
|
|
|
|
from enum import Enum, unique
|
|
|
|
|
2018-09-24 22:57:27 +00:00
|
|
|
from digest.checksums import compute_simple, compute_tarsum
|
2018-04-24 11:54:07 +00:00
|
|
|
from test.registry.protocols import (RegistryProtocol, Failures, ProtocolOptions, PushResult,
|
|
|
|
PullResult)
|
|
|
|
|
|
|
|
@unique
|
|
|
|
class V1ProtocolSteps(Enum):
|
|
|
|
""" Defines the various steps of the protocol, for matching failures. """
|
|
|
|
PUT_IMAGES = 'put-images'
|
|
|
|
GET_IMAGES = 'get-images'
|
2018-05-01 10:26:47 +00:00
|
|
|
PUT_TAG = 'put-tag'
|
2018-08-10 17:36:20 +00:00
|
|
|
PUT_IMAGE_JSON = 'put-image-json'
|
2018-09-24 14:50:48 +00:00
|
|
|
DELETE_TAG = 'delete-tag'
|
2018-04-24 11:54:07 +00:00
|
|
|
|
|
|
|
|
|
|
|
class V1Protocol(RegistryProtocol):
|
|
|
|
FAILURE_CODES = {
|
|
|
|
V1ProtocolSteps.PUT_IMAGES: {
|
|
|
|
Failures.UNAUTHENTICATED: 401,
|
|
|
|
Failures.UNAUTHORIZED: 403,
|
2018-05-01 10:26:47 +00:00
|
|
|
Failures.APP_REPOSITORY: 405,
|
2018-07-08 12:20:02 +00:00
|
|
|
Failures.SLASH_REPOSITORY: 404,
|
|
|
|
Failures.INVALID_REPOSITORY: 400,
|
2018-05-01 10:26:47 +00:00
|
|
|
Failures.DISALLOWED_LIBRARY_NAMESPACE: 400,
|
2018-05-22 22:36:04 +00:00
|
|
|
Failures.NAMESPACE_DISABLED: 400,
|
2018-04-24 11:54:07 +00:00
|
|
|
},
|
|
|
|
V1ProtocolSteps.GET_IMAGES: {
|
|
|
|
Failures.UNAUTHENTICATED: 403,
|
|
|
|
Failures.UNAUTHORIZED: 403,
|
2018-09-24 22:57:27 +00:00
|
|
|
Failures.APP_REPOSITORY: 404,
|
2018-05-01 10:26:47 +00:00
|
|
|
Failures.ANONYMOUS_NOT_ALLOWED: 401,
|
|
|
|
Failures.DISALLOWED_LIBRARY_NAMESPACE: 400,
|
2018-05-22 22:36:04 +00:00
|
|
|
Failures.NAMESPACE_DISABLED: 400,
|
2018-05-01 10:26:47 +00:00
|
|
|
},
|
2018-08-10 17:36:20 +00:00
|
|
|
V1ProtocolSteps.PUT_IMAGE_JSON: {
|
|
|
|
Failures.INVALID_IMAGES: 400,
|
|
|
|
},
|
2018-05-01 10:26:47 +00:00
|
|
|
V1ProtocolSteps.PUT_TAG: {
|
|
|
|
Failures.MISSING_TAG: 404,
|
|
|
|
Failures.INVALID_TAG: 400,
|
|
|
|
Failures.INVALID_IMAGES: 400,
|
2018-05-22 22:36:04 +00:00
|
|
|
Failures.NAMESPACE_DISABLED: 400,
|
2018-04-24 11:54:07 +00:00
|
|
|
},
|
|
|
|
}
|
|
|
|
|
|
|
|
def __init__(self, jwk):
|
|
|
|
pass
|
|
|
|
|
|
|
|
def _auth_for_credentials(self, credentials):
|
|
|
|
if credentials is None:
|
|
|
|
return None
|
|
|
|
|
|
|
|
return credentials
|
|
|
|
|
|
|
|
def ping(self, session):
|
|
|
|
assert session.get('/v1/_ping').status_code == 200
|
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
def login(self, session, username, password, scopes, expect_success):
|
|
|
|
data = {
|
|
|
|
'username': username,
|
|
|
|
'password': password,
|
|
|
|
}
|
|
|
|
|
|
|
|
response = self.conduct(session, 'POST', '/v1/users/', json_data=data, expected_status=400)
|
|
|
|
assert (response.text == '"Username or email already exists"') == expect_success
|
|
|
|
|
2018-04-24 11:54:07 +00:00
|
|
|
def pull(self, session, namespace, repo_name, tag_names, images, credentials=None,
|
|
|
|
expected_failure=None, options=None):
|
|
|
|
options = options or ProtocolOptions()
|
|
|
|
auth = self._auth_for_credentials(credentials)
|
|
|
|
tag_names = [tag_names] if isinstance(tag_names, str) else tag_names
|
2018-05-01 10:26:47 +00:00
|
|
|
prefix = '/v1/repositories/%s/' % self.repo_name(namespace, repo_name)
|
2018-04-24 11:54:07 +00:00
|
|
|
|
|
|
|
# Ping!
|
|
|
|
self.ping(session)
|
|
|
|
|
|
|
|
# GET /v1/repositories/{namespace}/{repository}/images
|
2018-05-01 10:26:47 +00:00
|
|
|
headers = {'X-Docker-Token': 'true'}
|
|
|
|
result = self.conduct(session, 'GET', prefix + 'images', auth=auth, headers=headers,
|
2018-04-24 11:54:07 +00:00
|
|
|
expected_status=(200, expected_failure, V1ProtocolSteps.GET_IMAGES))
|
2018-08-10 17:36:20 +00:00
|
|
|
if result.status_code != 200:
|
2018-04-24 11:54:07 +00:00
|
|
|
return
|
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
headers = {}
|
|
|
|
if credentials is not None:
|
|
|
|
headers['Authorization'] = 'token ' + result.headers['www-authenticate']
|
|
|
|
else:
|
|
|
|
assert not 'www-authenticate' in result.headers
|
|
|
|
|
2018-04-24 11:54:07 +00:00
|
|
|
# GET /v1/repositories/{namespace}/{repository}/tags
|
2018-05-01 10:26:47 +00:00
|
|
|
image_ids = self.conduct(session, 'GET', prefix + 'tags', headers=headers).json()
|
2018-04-24 11:54:07 +00:00
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
for tag_name in tag_names:
|
2018-08-10 17:36:20 +00:00
|
|
|
if tag_name not in image_ids:
|
|
|
|
assert expected_failure == Failures.UNKNOWN_TAG
|
|
|
|
return None
|
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
tag_image_id = image_ids[tag_name]
|
2018-04-24 11:54:07 +00:00
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
# Retrieve the ancestry of the tagged image.
|
|
|
|
image_prefix = '/v1/images/%s/' % tag_image_id
|
|
|
|
ancestors = self.conduct(session, 'GET', image_prefix + 'ancestry', headers=headers).json()
|
2018-04-24 11:54:07 +00:00
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
assert len(ancestors) == len(images)
|
|
|
|
for index, image_id in enumerate(reversed(ancestors)):
|
|
|
|
# /v1/images/{imageID}/{ancestry, json, layer}
|
|
|
|
image_prefix = '/v1/images/%s/' % image_id
|
|
|
|
self.conduct(session, 'GET', image_prefix + 'ancestry', headers=headers)
|
2018-04-24 11:54:07 +00:00
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
result = self.conduct(session, 'GET', image_prefix + 'json', headers=headers)
|
|
|
|
assert result.json()['id'] == image_id
|
2018-04-24 11:54:07 +00:00
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
# Ensure we can HEAD the image layer.
|
|
|
|
self.conduct(session, 'HEAD', image_prefix + 'layer', headers=headers)
|
2018-04-24 11:54:07 +00:00
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
# And retrieve the layer data.
|
|
|
|
result = self.conduct(session, 'GET', image_prefix + 'layer', headers=headers)
|
|
|
|
assert result.content == images[index].bytes
|
2018-04-24 11:54:07 +00:00
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
return PullResult(manifests=None, image_ids=image_ids)
|
2018-04-24 11:54:07 +00:00
|
|
|
|
|
|
|
def push(self, session, namespace, repo_name, tag_names, images, credentials=None,
|
|
|
|
expected_failure=None, options=None):
|
|
|
|
auth = self._auth_for_credentials(credentials)
|
|
|
|
tag_names = [tag_names] if isinstance(tag_names, str) else tag_names
|
|
|
|
|
|
|
|
# Ping!
|
|
|
|
self.ping(session)
|
|
|
|
|
|
|
|
# PUT /v1/repositories/{namespace}/{repository}/
|
2018-05-01 10:26:47 +00:00
|
|
|
result = self.conduct(session, 'PUT',
|
|
|
|
'/v1/repositories/%s/' % self.repo_name(namespace, repo_name),
|
2018-04-24 11:54:07 +00:00
|
|
|
expected_status=(201, expected_failure, V1ProtocolSteps.PUT_IMAGES),
|
|
|
|
json_data={},
|
|
|
|
auth=auth)
|
2018-08-10 17:36:20 +00:00
|
|
|
if result.status_code != 201:
|
2018-04-24 11:54:07 +00:00
|
|
|
return
|
|
|
|
|
|
|
|
headers = {}
|
|
|
|
headers['Authorization'] = 'token ' + result.headers['www-authenticate']
|
|
|
|
|
|
|
|
for image in images:
|
2018-11-14 11:21:50 +00:00
|
|
|
assert image.urls is None
|
|
|
|
|
2018-04-24 11:54:07 +00:00
|
|
|
# PUT /v1/images/{imageID}/json
|
|
|
|
image_json_data = {'id': image.id}
|
|
|
|
if image.size is not None:
|
|
|
|
image_json_data['Size'] = image.size
|
|
|
|
|
|
|
|
if image.parent_id is not None:
|
|
|
|
image_json_data['parent'] = image.parent_id
|
|
|
|
|
2018-05-01 10:26:47 +00:00
|
|
|
if image.config is not None:
|
|
|
|
image_json_data['config'] = image.config
|
|
|
|
|
2018-11-13 15:15:00 +00:00
|
|
|
if image.created is not None:
|
|
|
|
image_json_data['created'] = image.created
|
|
|
|
|
|
|
|
image_json = json.dumps(image_json_data)
|
2018-08-10 17:36:20 +00:00
|
|
|
response = self.conduct(session, 'PUT', '/v1/images/%s/json' % image.id,
|
2018-11-13 15:15:00 +00:00
|
|
|
data=image_json, headers=headers,
|
2018-08-10 17:36:20 +00:00
|
|
|
expected_status=(200, expected_failure,
|
|
|
|
V1ProtocolSteps.PUT_IMAGE_JSON))
|
|
|
|
if response.status_code != 200:
|
2018-09-24 22:57:27 +00:00
|
|
|
return
|
|
|
|
|
|
|
|
# PUT /v1/images/{imageID}/checksum (old style)
|
2018-11-13 15:15:00 +00:00
|
|
|
old_checksum = compute_tarsum(StringIO(image.bytes), image_json)
|
2018-09-24 22:57:27 +00:00
|
|
|
checksum_headers = {'X-Docker-Checksum': old_checksum}
|
|
|
|
checksum_headers.update(headers)
|
|
|
|
|
|
|
|
self.conduct(session, 'PUT', '/v1/images/%s/checksum' % image.id,
|
|
|
|
headers=checksum_headers)
|
2018-04-24 11:54:07 +00:00
|
|
|
|
|
|
|
# PUT /v1/images/{imageID}/layer
|
|
|
|
self.conduct(session, 'PUT', '/v1/images/%s/layer' % image.id,
|
|
|
|
data=StringIO(image.bytes), headers=headers)
|
|
|
|
|
2018-09-24 22:57:27 +00:00
|
|
|
# PUT /v1/images/{imageID}/checksum (new style)
|
2018-11-13 15:15:00 +00:00
|
|
|
checksum = compute_simple(StringIO(image.bytes), image_json)
|
2018-04-24 11:54:07 +00:00
|
|
|
checksum_headers = {'X-Docker-Checksum-Payload': checksum}
|
|
|
|
checksum_headers.update(headers)
|
|
|
|
|
|
|
|
self.conduct(session, 'PUT', '/v1/images/%s/checksum' % image.id,
|
|
|
|
headers=checksum_headers)
|
|
|
|
|
|
|
|
# PUT /v1/repositories/{namespace}/{repository}/tags/latest
|
|
|
|
for tag_name in tag_names:
|
|
|
|
self.conduct(session, 'PUT',
|
2018-05-01 10:26:47 +00:00
|
|
|
'/v1/repositories/%s/tags/%s' % (self.repo_name(namespace, repo_name), tag_name),
|
2018-04-24 11:54:07 +00:00
|
|
|
data='"%s"' % images[-1].id,
|
2018-05-01 10:26:47 +00:00
|
|
|
headers=headers,
|
|
|
|
expected_status=(200, expected_failure, V1ProtocolSteps.PUT_TAG))
|
2018-04-24 11:54:07 +00:00
|
|
|
|
|
|
|
# PUT /v1/repositories/{namespace}/{repository}/images
|
2018-05-01 10:26:47 +00:00
|
|
|
self.conduct(session, 'PUT',
|
|
|
|
'/v1/repositories/%s/images' % self.repo_name(namespace, repo_name),
|
2018-04-24 11:54:07 +00:00
|
|
|
expected_status=204, headers=headers)
|
|
|
|
|
2018-11-13 15:15:00 +00:00
|
|
|
return PushResult(manifests=None, headers=headers)
|
2018-09-24 14:50:48 +00:00
|
|
|
|
|
|
|
def delete(self, session, namespace, repo_name, tag_names, credentials=None,
|
|
|
|
expected_failure=None, options=None):
|
|
|
|
auth = self._auth_for_credentials(credentials)
|
|
|
|
tag_names = [tag_names] if isinstance(tag_names, str) else tag_names
|
|
|
|
|
|
|
|
# Ping!
|
|
|
|
self.ping(session)
|
|
|
|
|
|
|
|
for tag_name in tag_names:
|
|
|
|
# DELETE /v1/repositories/{namespace}/{repository}/tags/{tag}
|
|
|
|
self.conduct(session, 'DELETE',
|
|
|
|
'/v1/repositories/%s/tags/%s' % (self.repo_name(namespace, repo_name), tag_name),
|
|
|
|
auth=auth,
|
|
|
|
expected_status=(200, expected_failure, V1ProtocolSteps.DELETE_TAG))
|
2018-09-24 22:57:27 +00:00
|
|
|
|
|
|
|
def tag(self, session, namespace, repo_name, tag_name, image, credentials=None,
|
|
|
|
expected_failure=None, options=None):
|
|
|
|
auth = self._auth_for_credentials(credentials)
|
|
|
|
self.conduct(session, 'PUT',
|
|
|
|
'/v1/repositories/%s/tags/%s' % (self.repo_name(namespace, repo_name), tag_name),
|
|
|
|
data='"%s"' % image.id,
|
|
|
|
auth=auth,
|
|
|
|
expected_status=(200, expected_failure, V1ProtocolSteps.PUT_TAG))
|