Docker Registry

Run implements the push-oriented subset of Docker Registry v2 needed by Docker clients to upload image blobs and manifests. It is not a full pull-capable registry API.

Authentication

Registry endpoints require Basic Authentication configured through docker login.

1docker login run.hola.cloud

Supported Endpoints

GET /v2/

Check that the registry API is available.

curl -X GET "https://api.hola.cloud/v2/" \
  -H "Authorization: Basic <base64-credentials>"

GET /v2/ HTTP/1.1
Host: api.hola.cloud
Authorization: Basic <base64-credentials>

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.hola.cloud/v2/", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Basic <base64-credentials>")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	responseBody, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(responseBody))
}

<?php
$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.hola.cloud/v2/',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Basic <base64-credentials>',
    ],
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new Exception(curl_error($ch));
}
curl_close($ch);

echo $response;

import requests

headers = {
    "Authorization": "Basic <base64-credentials>",
}

response = requests.request(
    "GET",
    "https://api.hola.cloud/v2/",
    headers=headers
)

print(response.text)

const response = await fetch("https://api.hola.cloud/v2/", {
  method: "GET",
  headers: {
    "Authorization": "Basic <base64-credentials>"
  }
});

console.log(await response.text());

const response = await fetch("https://api.hola.cloud/v2/", {
  method: "GET",
  headers: {
    "Authorization": "Basic <base64-credentials>"
  }
});

const text = await response.text();
console.log(text);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.hola.cloud/v2/"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .header("Authorization", "Basic <base64-credentials>")
            .build();

        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

HEAD /v2/*

Check blob or manifest existence during a push workflow.

POST /v2/:repository/blobs/uploads/

Start a blob upload and receive an upload UUID.

curl -X POST "https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/" \
  -H "Authorization: Basic <base64-credentials>"

POST /v2/my-project/my-app/blobs/uploads/ HTTP/1.1
Host: api.hola.cloud
Authorization: Basic <base64-credentials>

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("POST", "https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Basic <base64-credentials>")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	responseBody, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(responseBody))
}

<?php
$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Basic <base64-credentials>',
    ],
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new Exception(curl_error($ch));
}
curl_close($ch);

echo $response;

import requests

headers = {
    "Authorization": "Basic <base64-credentials>",
}

response = requests.request(
    "POST",
    "https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/",
    headers=headers
)

print(response.text)

const response = await fetch("https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/", {
  method: "POST",
  headers: {
    "Authorization": "Basic <base64-credentials>"
  }
});

console.log(await response.text());

const response = await fetch("https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/", {
  method: "POST",
  headers: {
    "Authorization": "Basic <base64-credentials>"
  }
});

const text = await response.text();
console.log(text);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/"))
            .method("POST", HttpRequest.BodyPublishers.noBody())
            .header("Authorization", "Basic <base64-credentials>")
            .build();

        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

PATCH /v2/:repository/blobs/uploads/:uuid

Upload blob data.

curl -X PATCH "https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123" \
  -H "Authorization: Basic <base64-credentials>" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @layer.tar

PATCH /v2/my-project/my-app/blobs/uploads/abc-123 HTTP/1.1
Host: api.hola.cloud
Authorization: Basic <base64-credentials>
Content-Type: application/octet-stream

@layer.tar

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := "@layer.tar"

	req, err := http.NewRequest("PATCH", "https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123", strings.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Basic <base64-credentials>")
	req.Header.Set("Content-Type", "application/octet-stream")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	responseBody, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(responseBody))
}

<?php
$body = '@layer.tar';

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_HTTPHEADER => [
        'Authorization: Basic <base64-credentials>',
        'Content-Type: application/octet-stream',
    ],
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new Exception(curl_error($ch));
}
curl_close($ch);

echo $response;

import requests

headers = {
    "Authorization": "Basic <base64-credentials>",
    "Content-Type": "application/octet-stream",
}

body = "@layer.tar"

response = requests.request(
    "PATCH",
    "https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123",
    headers=headers,
    data=body
)

print(response.text)

const body = "@layer.tar";

const response = await fetch("https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123", {
  method: "PATCH",
  headers: {
    "Authorization": "Basic <base64-credentials>",
    "Content-Type": "application/octet-stream"
  },
  body
});

console.log(await response.text());

const body = "@layer.tar";

const response = await fetch("https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123", {
  method: "PATCH",
  headers: {
    "Authorization": "Basic <base64-credentials>",
    "Content-Type": "application/octet-stream"
  },
  body
});

const text = await response.text();
console.log(text);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var body = """
@layer.tar
""";

        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123"))
            .method("PATCH", HttpRequest.BodyPublishers.ofString(body))
            .header("Authorization", "Basic <base64-credentials>")
            .header("Content-Type", "application/octet-stream")
            .build();

        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

PUT /v2/:repository/blobs/uploads/:uuid

Finalize a blob upload with its digest.

curl -X PUT "https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123?digest=sha256:a1b2c3d4..." \
  -H "Authorization: Basic <base64-credentials>" \
  -H "Content-Type: application/octet-stream"

PUT /v2/my-project/my-app/blobs/uploads/abc-123?digest=sha256:a1b2c3d4... HTTP/1.1
Host: api.hola.cloud
Authorization: Basic <base64-credentials>
Content-Type: application/octet-stream

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("PUT", "https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123?digest=sha256:a1b2c3d4...", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Basic <base64-credentials>")
	req.Header.Set("Content-Type", "application/octet-stream")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	responseBody, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(responseBody))
}

<?php
$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123?digest=sha256:a1b2c3d4...',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_HTTPHEADER => [
        'Authorization: Basic <base64-credentials>',
        'Content-Type: application/octet-stream',
    ],
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new Exception(curl_error($ch));
}
curl_close($ch);

echo $response;

import requests

headers = {
    "Authorization": "Basic <base64-credentials>",
    "Content-Type": "application/octet-stream",
}

response = requests.request(
    "PUT",
    "https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123?digest=sha256:a1b2c3d4...",
    headers=headers
)

print(response.text)

const response = await fetch("https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123?digest=sha256:a1b2c3d4...", {
  method: "PUT",
  headers: {
    "Authorization": "Basic <base64-credentials>",
    "Content-Type": "application/octet-stream"
  }
});

console.log(await response.text());

const response = await fetch("https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123?digest=sha256:a1b2c3d4...", {
  method: "PUT",
  headers: {
    "Authorization": "Basic <base64-credentials>",
    "Content-Type": "application/octet-stream"
  }
});

const text = await response.text();
console.log(text);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.hola.cloud/v2/my-project/my-app/blobs/uploads/abc-123?digest=sha256:a1b2c3d4..."))
            .method("PUT", HttpRequest.BodyPublishers.noBody())
            .header("Authorization", "Basic <base64-credentials>")
            .header("Content-Type", "application/octet-stream")
            .build();

        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

PUT /v2/:repository/manifests/:reference

Push a manifest for a tag or reference.

curl -X PUT "https://api.hola.cloud/v2/my-project/my-app/manifests/latest" \
  -H "Authorization: Basic <base64-credentials>" \
  -H "Content-Type: application/vnd.docker.distribution.manifest.v2+json" \
  --data-binary @manifest.json

PUT /v2/my-project/my-app/manifests/latest HTTP/1.1
Host: api.hola.cloud
Authorization: Basic <base64-credentials>
Content-Type: application/vnd.docker.distribution.manifest.v2+json

@manifest.json

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := "@manifest.json"

	req, err := http.NewRequest("PUT", "https://api.hola.cloud/v2/my-project/my-app/manifests/latest", strings.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Basic <base64-credentials>")
	req.Header.Set("Content-Type", "application/vnd.docker.distribution.manifest.v2+json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	responseBody, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(responseBody))
}

<?php
$body = '@manifest.json';

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.hola.cloud/v2/my-project/my-app/manifests/latest',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_HTTPHEADER => [
        'Authorization: Basic <base64-credentials>',
        'Content-Type: application/vnd.docker.distribution.manifest.v2+json',
    ],
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new Exception(curl_error($ch));
}
curl_close($ch);

echo $response;

import requests

headers = {
    "Authorization": "Basic <base64-credentials>",
    "Content-Type": "application/vnd.docker.distribution.manifest.v2+json",
}

body = "@manifest.json"

response = requests.request(
    "PUT",
    "https://api.hola.cloud/v2/my-project/my-app/manifests/latest",
    headers=headers,
    data=body
)

print(response.text)

const body = "@manifest.json";

const response = await fetch("https://api.hola.cloud/v2/my-project/my-app/manifests/latest", {
  method: "PUT",
  headers: {
    "Authorization": "Basic <base64-credentials>",
    "Content-Type": "application/vnd.docker.distribution.manifest.v2+json"
  },
  body
});

console.log(await response.text());

const body = "@manifest.json";

const response = await fetch("https://api.hola.cloud/v2/my-project/my-app/manifests/latest", {
  method: "PUT",
  headers: {
    "Authorization": "Basic <base64-credentials>",
    "Content-Type": "application/vnd.docker.distribution.manifest.v2+json"
  },
  body
});

const text = await response.text();
console.log(text);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var body = """
@manifest.json
""";

        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.hola.cloud/v2/my-project/my-app/manifests/latest"))
            .method("PUT", HttpRequest.BodyPublishers.ofString(body))
            .header("Authorization", "Basic <base64-credentials>")
            .header("Content-Type", "application/vnd.docker.distribution.manifest.v2+json")
            .build();

        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}