|
|
|
|
|
<!doctype html>
|
|
|
<html lang="en" class="no-js">
|
|
|
<head>
|
|
|
|
|
|
<meta charset="utf-8">
|
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="canonical" href="http://containrrr.github.io/watchtower/private-registries/">
|
|
|
|
|
|
<link rel="icon" href="../images/favicon.ico">
|
|
|
<meta name="generator" content="mkdocs-1.1.2, mkdocs-material-7.1.3">
|
|
|
|
|
|
|
|
|
|
|
|
<title>Private registries - Watchtower</title>
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="../assets/stylesheets/main.e35208c4.min.css">
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="../assets/stylesheets/palette.ef6f36e2.min.css">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
|
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
|
|
|
<style>:root{--md-text-font-family:"Roboto";--md-code-font-family:"Roboto Mono"}</style>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="../stylesheets/theme.css">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<body dir="ltr" data-md-color-scheme="containrrr" data-md-color-primary="" data-md-color-accent="">
|
|
|
|
|
|
|
|
|
<script>function __prefix(e){return new URL("..",location).pathname+"."+e}function __get(e,t=localStorage){return JSON.parse(t.getItem(__prefix(e)))}</script>
|
|
|
|
|
|
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
|
|
|
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
|
|
|
<label class="md-overlay" for="__drawer"></label>
|
|
|
<div data-md-component="skip">
|
|
|
|
|
|
|
|
|
<a href="#create_the_configuration_file_manually" class="md-skip">
|
|
|
Skip to content
|
|
|
</a>
|
|
|
|
|
|
</div>
|
|
|
<div data-md-component="announce">
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<header class="md-header" data-md-component="header">
|
|
|
<nav class="md-header__inner md-grid" aria-label="Header">
|
|
|
<a href=".." title="Watchtower" class="md-header__button md-logo" aria-label="Watchtower" data-md-component="logo">
|
|
|
|
|
|
<img src="../images/logo-450px.png" alt="logo">
|
|
|
|
|
|
</a>
|
|
|
<label class="md-header__button md-icon" for="__drawer">
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
|
|
|
</label>
|
|
|
<div class="md-header__title" data-md-component="header-title">
|
|
|
<div class="md-header__ellipsis">
|
|
|
<div class="md-header__topic">
|
|
|
<span class="md-ellipsis">
|
|
|
Watchtower
|
|
|
</span>
|
|
|
</div>
|
|
|
<div class="md-header__topic" data-md-component="header-topic">
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Private registries
|
|
|
|
|
|
</span>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<label class="md-header__button md-icon" for="__search">
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
|
|
|
</label>
|
|
|
|
|
|
<div class="md-search" data-md-component="search" role="dialog">
|
|
|
<label class="md-search__overlay" for="__search"></label>
|
|
|
<div class="md-search__inner" role="search">
|
|
|
<form class="md-search__form" name="search">
|
|
|
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active" required>
|
|
|
<label class="md-search__icon md-icon" for="__search">
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
|
|
|
</label>
|
|
|
<button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1">
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
|
|
|
</button>
|
|
|
</form>
|
|
|
<div class="md-search__output">
|
|
|
<div class="md-search__scrollwrap" data-md-scrollfix>
|
|
|
<div class="md-search-result" data-md-component="search-result">
|
|
|
<div class="md-search-result__meta">
|
|
|
Initializing search
|
|
|
</div>
|
|
|
<ol class="md-search-result__list"></ol>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
|
|
|
<div class="md-header__source">
|
|
|
|
|
|
<a href="https://github.com/containrrr/watchtower/" title="Go to repository" class="md-source" data-md-component="source">
|
|
|
<div class="md-source__icon md-icon">
|
|
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
|
|
|
</div>
|
|
|
<div class="md-source__repository">
|
|
|
GitHub
|
|
|
</div>
|
|
|
</a>
|
|
|
</div>
|
|
|
|
|
|
</nav>
|
|
|
</header>
|
|
|
|
|
|
<div class="md-container" data-md-component="container">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<main class="md-main" data-md-component="main">
|
|
|
<div class="md-main__inner md-grid">
|
|
|
|
|
|
|
|
|
|
|
|
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
|
|
|
<div class="md-sidebar__scrollwrap">
|
|
|
<div class="md-sidebar__inner">
|
|
|
|
|
|
|
|
|
|
|
|
<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
|
|
|
<label class="md-nav__title" for="__drawer">
|
|
|
<a href=".." title="Watchtower" class="md-nav__button md-logo" aria-label="Watchtower" data-md-component="logo">
|
|
|
|
|
|
<img src="../images/logo-450px.png" alt="logo">
|
|
|
|
|
|
</a>
|
|
|
Watchtower
|
|
|
</label>
|
|
|
|
|
|
<div class="md-nav__source">
|
|
|
|
|
|
<a href="https://github.com/containrrr/watchtower/" title="Go to repository" class="md-source" data-md-component="source">
|
|
|
<div class="md-source__icon md-icon">
|
|
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
|
|
|
</div>
|
|
|
<div class="md-source__repository">
|
|
|
GitHub
|
|
|
</div>
|
|
|
</a>
|
|
|
</div>
|
|
|
|
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href=".." class="md-nav__link">
|
|
|
Home
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../introduction/" class="md-nav__link">
|
|
|
Introduction
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../usage-overview/" class="md-nav__link">
|
|
|
Usage overview
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../arguments/" class="md-nav__link">
|
|
|
Arguments
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../notifications/" class="md-nav__link">
|
|
|
Notifications
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../container-selection/" class="md-nav__link">
|
|
|
Container selection
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--active">
|
|
|
|
|
|
<input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
|
|
|
|
|
|
|
|
|
|
|
|
<label class="md-nav__link md-nav__link--active" for="__toc">
|
|
|
Private registries
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
</label>
|
|
|
|
|
|
<a href="./" class="md-nav__link md-nav__link--active">
|
|
|
Private registries
|
|
|
</a>
|
|
|
|
|
|
|
|
|
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<label class="md-nav__title" for="__toc">
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
Table of contents
|
|
|
</label>
|
|
|
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#create_the_configuration_file_manually" class="md-nav__link">
|
|
|
Create the configuration file manually
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#i_username_and_password_for_gcloud" class="md-nav__link">
|
|
|
ℹ️ Username and Password for GCloud
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#share_the_docker_configuration_file" class="md-nav__link">
|
|
|
Share the Docker configuration file
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav" aria-label="Share the Docker configuration file">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#docker_config_path" class="md-nav__link">
|
|
|
Docker Config path
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#credential_helpers" class="md-nav__link">
|
|
|
Credential helpers
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav" aria-label="Credential helpers">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#example" class="md-nav__link">
|
|
|
Example
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#create_a_volume_to_store_the_command_once_built" class="md-nav__link">
|
|
|
Create a volume to store the command (once built)
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#build_the_container" class="md-nav__link">
|
|
|
Build the container
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#build_the_command_and_store_it_in_the_new_volume_in_the_gobin_directory" class="md-nav__link">
|
|
|
Build the command and store it in the new volume in the /go/bin directory.
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../linked-containers/" class="md-nav__link">
|
|
|
Linked containers
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../remote-hosts/" class="md-nav__link">
|
|
|
Remote hosts
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../secure-connections/" class="md-nav__link">
|
|
|
Secure connections
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../stop-signals/" class="md-nav__link">
|
|
|
Stop signals
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../lifecycle-hooks/" class="md-nav__link">
|
|
|
Lifecycle hooks
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../running-multiple-instances/" class="md-nav__link">
|
|
|
Running multiple instances
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="../metrics/" class="md-nav__link">
|
|
|
Metrics
|
|
|
</a>
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
|
|
|
<div class="md-sidebar__scrollwrap">
|
|
|
<div class="md-sidebar__inner">
|
|
|
|
|
|
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<label class="md-nav__title" for="__toc">
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
Table of contents
|
|
|
</label>
|
|
|
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#create_the_configuration_file_manually" class="md-nav__link">
|
|
|
Create the configuration file manually
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#i_username_and_password_for_gcloud" class="md-nav__link">
|
|
|
ℹ️ Username and Password for GCloud
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#share_the_docker_configuration_file" class="md-nav__link">
|
|
|
Share the Docker configuration file
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav" aria-label="Share the Docker configuration file">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#docker_config_path" class="md-nav__link">
|
|
|
Docker Config path
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#credential_helpers" class="md-nav__link">
|
|
|
Credential helpers
|
|
|
</a>
|
|
|
|
|
|
<nav class="md-nav" aria-label="Credential helpers">
|
|
|
<ul class="md-nav__list">
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#example" class="md-nav__link">
|
|
|
Example
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
</nav>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#create_a_volume_to_store_the_command_once_built" class="md-nav__link">
|
|
|
Create a volume to store the command (once built)
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#build_the_container" class="md-nav__link">
|
|
|
Build the container
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li class="md-nav__item">
|
|
|
<a href="#build_the_command_and_store_it_in_the_new_volume_in_the_gobin_directory" class="md-nav__link">
|
|
|
Build the command and store it in the new volume in the /go/bin directory.
|
|
|
</a>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
</nav>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
|
|
|
<div class="md-content" data-md-component="content">
|
|
|
<article class="md-content__inner md-typeset">
|
|
|
|
|
|
|
|
|
<a href="https://github.com/containrrr/watchtower/edit/main/docs/private-registries.md" title="Edit this page" class="md-content__button md-icon">
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg>
|
|
|
</a>
|
|
|
|
|
|
|
|
|
<p>Watchtower supports private Docker image registries. In many cases, accessing a private registry
|
|
|
requires a valid username and password (i.e., <em>credentials</em>). In order to operate in such an
|
|
|
environment, watchtower needs to know the credentials to access the registry. </p>
|
|
|
<p>The credentials can be provided to watchtower in a configuration file called <code>config.json</code>.
|
|
|
There are two ways to generate this configuration file:</p>
|
|
|
<ul>
|
|
|
<li>The configuration file can be created manually.</li>
|
|
|
<li>Call <code>docker login <REGISTRY_NAME></code> and share the resulting configuration file.</li>
|
|
|
</ul>
|
|
|
<h3 id="create_the_configuration_file_manually">Create the configuration file manually<a class="headerlink" href="#create_the_configuration_file_manually" title="Permanent link">¶</a></h3>
|
|
|
<p>Create a new configuration file with the following syntax and a base64 encoded username and
|
|
|
password <code>auth</code> string:</p>
|
|
|
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
|
|
<span class="nt">"auths"</span><span class="p">:</span> <span class="p">{</span>
|
|
|
<span class="nt">"<REGISTRY_NAME>"</span><span class="p">:</span> <span class="p">{</span>
|
|
|
<span class="nt">"auth"</span><span class="p">:</span> <span class="s2">"XXXXXXX"</span>
|
|
|
<span class="p">}</span>
|
|
|
<span class="p">}</span>
|
|
|
<span class="p">}</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<p><code><REGISTRY_NAME></code> needs to be replaced by the name of your private registry
|
|
|
(e.g., <code>my-private-registry.example.org</code>)</p>
|
|
|
<p>The required <code>auth</code> string can be generated as follows:</p>
|
|
|
<div class="codehilite"><pre><span></span><code><span class="nb">echo</span> -n <span class="s1">'username:password'</span> <span class="p">|</span> base64
|
|
|
</code></pre></div>
|
|
|
|
|
|
<blockquote>
|
|
|
<h3 id="i_username_and_password_for_gcloud">ℹ️ Username and Password for GCloud<a class="headerlink" href="#i_username_and_password_for_gcloud" title="Permanent link">¶</a></h3>
|
|
|
<p>For gcloud, we'll use <code>_json_key</code> as our username and the content
|
|
|
of <code>gcloudauth.json</code> as the password.
|
|
|
<code>bash
|
|
|
echo -n "_json_key:$(cat gcloudauth.json)" | base64 -w0</code>
|
|
|
When the watchtower Docker container is started, the created configuration file
|
|
|
(<code><PATH>/config.json</code> in this example) needs to be passed to the container:</p>
|
|
|
</blockquote>
|
|
|
<div class="codehilite"><pre><span></span><code>docker run <span class="o">[</span>...<span class="o">]</span> -v <PATH>/config.json:/config.json containrrr/watchtower
|
|
|
</code></pre></div>
|
|
|
|
|
|
<h3 id="share_the_docker_configuration_file">Share the Docker configuration file<a class="headerlink" href="#share_the_docker_configuration_file" title="Permanent link">¶</a></h3>
|
|
|
<p>To pull an image from a private registry, <code>docker login</code> needs to be called first, to get access
|
|
|
to the registry. The provided credentials are stored in a configuration file called <code><PATH_TO_HOME_DIR>/.docker/config.json</code>.
|
|
|
This configuration file can be directly used by watchtower. In this case, the creation of an
|
|
|
additional configuration file is not necessary.</p>
|
|
|
<p>When the Docker container is started, pass the configuration file to watchtower:</p>
|
|
|
<div class="codehilite"><pre><span></span><code>docker run <span class="o">[</span>...<span class="o">]</span> -v <PATH_TO_HOME_DIR>/.docker/config.json:/config.json containrrr/watchtower
|
|
|
</code></pre></div>
|
|
|
|
|
|
<p>When creating the watchtower container via docker-compose, use the following lines:</p>
|
|
|
<div class="codehilite"><pre><span></span><code><span class="nt">version</span><span class="p">:</span> <span class="s">"3.4"</span>
|
|
|
<span class="nt">services</span><span class="p">:</span>
|
|
|
<span class="nt">watchtower</span><span class="p">:</span>
|
|
|
<span class="nt">image</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">index.docker.io/containrrr/watchtower:latest</span>
|
|
|
<span class="nt">volumes</span><span class="p">:</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">/var/run/docker.sock:/var/run/docker.sock</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain"><PATH_TO_HOME_DIR>/.docker/config.json:/config.json</span>
|
|
|
<span class="l l-Scalar l-Scalar-Plain">...</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<h4 id="docker_config_path">Docker Config path<a class="headerlink" href="#docker_config_path" title="Permanent link">¶</a></h4>
|
|
|
<p>By default, watchtower will look for the <code>config.json</code> file in <code>/</code>, but this can be changed by setting the <code>DOCKER_CONFIG</code> environment variable to the directory path where your config is located. This is useful for setups where the config.json file is changed while the watchtower instance is running, as the changes will not be picked up for a mounted file if the inode changes.
|
|
|
Example usage:</p>
|
|
|
<div class="codehilite"><pre><span></span><code><span class="nt">version</span><span class="p">:</span> <span class="s">"3.4"</span>
|
|
|
|
|
|
<span class="nt">services</span><span class="p">:</span>
|
|
|
<span class="nt">watchtower</span><span class="p">:</span>
|
|
|
<span class="nt">image</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">containrrr/watchtower</span>
|
|
|
<span class="nt">environment</span><span class="p">:</span>
|
|
|
<span class="nt">DOCKER_CONFIG</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">/config</span>
|
|
|
<span class="nt">volumes</span><span class="p">:</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">/etc/watchtower/config/:/config/</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">/var/run/docker.sock:/var/run/docker.sock</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<h2 id="credential_helpers">Credential helpers<a class="headerlink" href="#credential_helpers" title="Permanent link">¶</a></h2>
|
|
|
<p>Some private Docker registries (the most prominent probably being AWS ECR) use non-standard ways of authentication.
|
|
|
To be able to use this together with watchtower, we need to use a credential helper.</p>
|
|
|
<p>To keep the image size small we've decided to not include any helpers in the watchtower image, instead we'll put the
|
|
|
helper in a separate container and mount it using volumes.</p>
|
|
|
<h3 id="example">Example<a class="headerlink" href="#example" title="Permanent link">¶</a></h3>
|
|
|
<p>Example implementation for use with <a href="https://github.com/awslabs/amazon-ecr-credential-helper">amazon-ecr-credential-helper</a>:</p>
|
|
|
<p>Use the dockerfile below to build the <a href="https://github.com/awslabs/amazon-ecr-credential-helper">amazon-ecr-credential-helper</a>,
|
|
|
in a volume that may be mounted onto your watchtower container.</p>
|
|
|
<ol>
|
|
|
<li>Create the Dockerfile (contents below): </li>
|
|
|
</ol>
|
|
|
<div class="codehilite"><pre><span></span><code><span class="k">FROM</span> <span class="s">golang:latest</span>
|
|
|
|
|
|
<span class="k">ENV</span> CGO_ENABLED <span class="m">0</span>
|
|
|
<span class="k">ENV</span> REPO github.com/awslabs/amazon-ecr-credential-helper/ecr-login/cli/docker-credential-ecr-login
|
|
|
|
|
|
<span class="k">RUN</span> go get -u <span class="nv">$REPO</span>
|
|
|
|
|
|
<span class="k">RUN</span> rm /go/bin/docker-credential-ecr-login
|
|
|
|
|
|
<span class="k">RUN</span> go build <span class="se">\</span>
|
|
|
-o /go/bin/docker-credential-ecr-login <span class="se">\</span>
|
|
|
/go/src/<span class="nv">$REPO</span>
|
|
|
|
|
|
<span class="k">WORKDIR</span><span class="s"> /go/bin/</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<ol>
|
|
|
<li>Use the following commands to build the aws-ecr-dock-cred-helper and store it's output in a volume:</li>
|
|
|
</ol>
|
|
|
<p>```shell script</p>
|
|
|
<h1 id="create_a_volume_to_store_the_command_once_built">Create a volume to store the command (once built)<a class="headerlink" href="#create_a_volume_to_store_the_command_once_built" title="Permanent link">¶</a></h1>
|
|
|
<p>docker volume create helper </p>
|
|
|
<h1 id="build_the_container">Build the container<a class="headerlink" href="#build_the_container" title="Permanent link">¶</a></h1>
|
|
|
<p>docker build -t aws-ecr-dock-cred-helper .</p>
|
|
|
<h1 id="build_the_command_and_store_it_in_the_new_volume_in_the_gobin_directory">Build the command and store it in the new volume in the /go/bin directory.<a class="headerlink" href="#build_the_command_and_store_it_in_the_new_volume_in_the_gobin_directory" title="Permanent link">¶</a></h1>
|
|
|
<p>docker run -d --rm --name aws-cred-helper --volume helper:/go/bin aws-ecr-dock-cred-helper</p>
|
|
|
<div class="codehilite"><pre><span></span><code><span class="mf">3.</span> <span class="n">Create</span> <span class="n">a</span> <span class="n">configuration</span> <span class="n">file</span> <span class="kr">for</span> <span class="n">docker</span><span class="p">,</span> <span class="ow">and</span> <span class="n">store</span> <span class="n">it</span> <span class="n">in</span> <span class="err">$</span><span class="n">HOME</span><span class="o">/</span><span class="mf">.</span><span class="n">docker</span><span class="o">/</span><span class="n">config</span><span class="mf">.</span><span class="n">json</span> <span class="p">(</span><span class="n">replace</span> <span class="n">the</span> <span class="o"><</span><span class="n">AWS_ACCOUNT_ID</span><span class="o">></span>
|
|
|
<span class="n">placeholders</span> <span class="n">with</span> <span class="n">your</span> <span class="n">AWS</span> <span class="n">Account</span> <span class="n">ID</span><span class="p">):</span>
|
|
|
|
|
|
<span class="err">```</span><span class="n">json</span>
|
|
|
<span class="err">{</span>
|
|
|
<span class="s">"credsStore"</span> <span class="p">:</span> <span class="s">"ecr-login"</span><span class="p">,</span>
|
|
|
<span class="s">"HttpHeaders"</span> <span class="p">:</span> <span class="err">{</span>
|
|
|
<span class="s">"User-Agent"</span> <span class="p">:</span> <span class="s">"Docker-Client/19.03.1 (XXXXXX)"</span>
|
|
|
<span class="err">}</span><span class="p">,</span>
|
|
|
<span class="s">"auths"</span> <span class="p">:</span> <span class="err">{</span>
|
|
|
<span class="s">"<AWS_ACCOUNT_ID>.dkr.ecr.us-west-1.amazonaws.com"</span> <span class="p">:</span> <span class="err">{}</span>
|
|
|
<span class="err">}</span><span class="p">,</span>
|
|
|
<span class="s">"credHelpers"</span><span class="p">:</span> <span class="err">{</span>
|
|
|
<span class="s">"<AWS_ACCOUNT_ID>.dkr.ecr.us-west-1.amazonaws.com"</span> <span class="p">:</span> <span class="s">"ecr-login"</span>
|
|
|
<span class="err">}</span>
|
|
|
<span class="err">}</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<ol>
|
|
|
<li>Create a docker-compose file (as an example) to help launch the container:</li>
|
|
|
</ol>
|
|
|
<p>and the docker-compose definition:</p>
|
|
|
<div class="codehilite"><pre><span></span><code><span class="nt">version</span><span class="p">:</span> <span class="s">"3.4"</span>
|
|
|
<span class="nt">services</span><span class="p">:</span>
|
|
|
<span class="c1"># Check for new images and restart things if a new image exists</span>
|
|
|
<span class="c1"># for any of our containers.</span>
|
|
|
<span class="nt">watchtower</span><span class="p">:</span>
|
|
|
<span class="nt">image</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">containrrr/watchtower:latest</span>
|
|
|
<span class="nt">volumes</span><span class="p">:</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">/var/run/docker.sock:/var/run/docker.sock</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">.docker/config.json:/config.json</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">helper:/go/bin</span>
|
|
|
<span class="nt">environment</span><span class="p">:</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">HOME=/</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">PATH=$PATH:/go/bin</span>
|
|
|
<span class="p p-Indicator">-</span> <span class="l l-Scalar l-Scalar-Plain">AWS_REGION=us-west-1</span>
|
|
|
<span class="nt">volumes</span><span class="p">:</span>
|
|
|
<span class="nt">helper</span><span class="p">:</span>
|
|
|
<span class="nt">external</span><span class="p">:</span> <span class="l l-Scalar l-Scalar-Plain">true</span>
|
|
|
</code></pre></div>
|
|
|
|
|
|
<p>A few additional notes:</p>
|
|
|
<ol>
|
|
|
<li>With docker-compose the volume (helper, in this case) MUST be set to <code>external: true</code>, otherwise docker-compose
|
|
|
will preface it with the directory name.</li>
|
|
|
<li>Note that "credsStore" : "ecr-login" is needed - and in theory if you have that you can remove the
|
|
|
credHelpers section </li>
|
|
|
<li>I have this running on an EC2 instance that has credentials assigned to it - so no keys are needed; however,
|
|
|
you may need to include the <code>AWS_ACCESS_KEY_ID</code> and <code>AWS_SECRET_ACCESS_KEY</code> environment variables as well.</li>
|
|
|
<li>An alternative to adding the various variables is to create a ~/.aws/config and ~/.aws/credentials files and
|
|
|
place the settings there, then mount the ~/.aws directory to / in the container.</li>
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</article>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
</main>
|
|
|
|
|
|
|
|
|
<footer class="md-footer">
|
|
|
|
|
|
<nav class="md-footer__inner md-grid" aria-label="Footer">
|
|
|
|
|
|
<a href="../container-selection/" class="md-footer__link md-footer__link--prev" rel="prev">
|
|
|
<div class="md-footer__button md-icon">
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
|
|
|
</div>
|
|
|
<div class="md-footer__title">
|
|
|
<div class="md-ellipsis">
|
|
|
<span class="md-footer__direction">
|
|
|
Previous
|
|
|
</span>
|
|
|
Container selection
|
|
|
</div>
|
|
|
</div>
|
|
|
</a>
|
|
|
|
|
|
|
|
|
<a href="../linked-containers/" class="md-footer__link md-footer__link--next" rel="next">
|
|
|
<div class="md-footer__title">
|
|
|
<div class="md-ellipsis">
|
|
|
<span class="md-footer__direction">
|
|
|
Next
|
|
|
</span>
|
|
|
Linked containers
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="md-footer__button md-icon">
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
|
|
|
</div>
|
|
|
</a>
|
|
|
|
|
|
</nav>
|
|
|
|
|
|
<div class="md-footer-meta md-typeset">
|
|
|
<div class="md-footer-meta__inner md-grid">
|
|
|
<div class="md-footer-copyright">
|
|
|
|
|
|
Made with
|
|
|
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
|
|
|
Material for MkDocs
|
|
|
</a>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
</div>
|
|
|
</footer>
|
|
|
|
|
|
</div>
|
|
|
<div class="md-dialog" data-md-component="dialog">
|
|
|
<div class="md-dialog__inner md-typeset"></div>
|
|
|
</div>
|
|
|
<script id="__config" type="application/json">{"base": "..", "features": [], "translations": {"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}, "search": "../assets/javascripts/workers/search.fe42c31b.min.js", "version": null}</script>
|
|
|
|
|
|
|
|
|
<script src="../assets/javascripts/bundle.4ea5477f.min.js"></script>
|
|
|
|
|
|
|
|
|
</body>
|
|
|
</html> |