github.com/AliyunContainerService/cli@v0.0.0-20181009023821-814ced4b30d0/docs/reference/commandline/trust_signer_remove.md (about)

     1  ---
     2  title: "signer remove"
     3  description: "The signer remove command description and usage"
     4  keywords: "signer, notary, trust"
     5  ---
     6  
     7  <!-- This file is maintained within the docker/cli Github
     8       repository at https://github.com/docker/cli/. Make all
     9       pull requests against that repo. If you see this file in
    10       another repository, consider it read-only there, as it will
    11       periodically be overwritten by the definitive file. Pull
    12       requests which include edits to this file in other repositories
    13       will be rejected.
    14  -->
    15  
    16  # trust signer remove
    17  
    18  ```markdown
    19  Usage:	docker trust signer remove [OPTIONS] NAME REPOSITORY [REPOSITORY...]
    20  
    21  Remove a signer
    22  
    23  Options:
    24    -f, --force   Do not prompt for confirmation before removing the most recent signer
    25    --help        Print usage
    26  ```
    27  
    28  ## Description
    29  
    30  `docker trust signer remove` removes signers from signed repositories.
    31  
    32  ## Examples
    33  
    34  ### Remove a signer from a repo
    35  
    36  To remove an existing signer, `alice`, from this repository: 
    37  
    38  ```bash
    39  $ docker trust view example/trust-demo
    40  
    41  No signatures for example/trust-demo
    42  
    43  
    44  List of signers and their keys:
    45  
    46  SIGNER              KEYS
    47  alice               05e87edcaecb
    48  bob                 5600f5ab76a2
    49  
    50  Administrative keys for example/trust-demo:
    51  Repository Key:	ecc457614c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4555b3c6ab02f71e
    52  Root Key:	3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
    53  ```
    54  
    55  Remove `alice` with `docker trust signer remove`:
    56  
    57  ```bash
    58  $ docker trust signer remove alice example/trust-demo
    59    Removing signer "alice" from image example/trust-demo...
    60    Enter passphrase for repository key with ID 642692c: 
    61    Successfully removed alice from example/trust-demo
    62  
    63  ```
    64  
    65  `docker trust view` now does not list `alice` as a valid signer:
    66  
    67  ```bash
    68  $ docker trust view example/trust-demo
    69  
    70  No signatures for example/trust-demo
    71  
    72  
    73  List of signers and their keys:
    74  
    75  SIGNER              KEYS
    76  bob                 5600f5ab76a2
    77  
    78  Administrative keys for example/trust-demo:
    79  Repository Key:	ecc457614c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4555b3c6ab02f71e
    80  Root Key:	3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
    81  ```
    82  
    83  ### Remove a signer from multiple repos
    84  
    85  To remove an existing signer, `alice`, from multiple repositories: 
    86  
    87  ```bash
    88  $ docker trust view example/trust-demo
    89  SIGNED TAG          DIGEST                                                             SIGNERS
    90  v1                  74d4bfa917d55d53c7df3d2ab20a8d926874d61c3da5ef6de15dd2654fc467c4   alice, bob
    91  
    92  List of signers and their keys:
    93  
    94  SIGNER              KEYS
    95  alice               05e87edcaecb
    96  bob                 5600f5ab76a2
    97  
    98  Administrative keys for example/trust-demo:
    99  Repository Key:	95b9e5514c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4555b3c6ab02f71e
   100  Root Key:	3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
   101  ```
   102  ```bash
   103  $ docker trust view example/trust-demo2
   104  SIGNED TAG          DIGEST                                                             SIGNERS
   105  v1                  74d4bfa917d55d53c7df3d2ab20a8d926874d61c3da5ef6de15dd2654fc467c4   alice, bob
   106  
   107  List of signers and their keys:
   108  
   109  SIGNER              KEYS
   110  alice               05e87edcaecb
   111  bob                 5600f5ab76a2
   112  
   113  Administrative keys for example/trust-demo2:
   114  Repository Key:	ece554f14c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4553d2ab20a8d9268
   115  Root Key:	3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
   116  ```
   117  Remove `alice` from both images with a single `docker trust signer remove` command:
   118  
   119  ```bash
   120  $ docker trust signer remove alice example/trust-demo example/trust-demo2
   121  Removing signer "alice" from image example/trust-demo...
   122  Enter passphrase for repository key with ID 95b9e55: 
   123  Successfully removed alice from example/trust-demo
   124  
   125  Removing signer "alice" from image example/trust-demo2...
   126  Enter passphrase for repository key with ID ece554f: 
   127  Successfully removed alice from example/trust-demo2
   128  ```
   129  `docker trust view` no longer lists `alice` as a valid signer of either `example/trust-demo` or `example/trust-demo2`:
   130  ```bash
   131  $ docker trust view example/trust-demo
   132  SIGNED TAG          DIGEST                                                             SIGNERS
   133  v1                  74d4bfa917d55d53c7df3d2ab20a8d926874d61c3da5ef6de15dd2654fc467c4   bob
   134  
   135  List of signers and their keys:
   136  
   137  SIGNER              KEYS
   138  bob                 5600f5ab76a2
   139  
   140  Administrative keys for example/trust-demo:
   141  Repository Key:	ecc457614c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4555b3c6ab02f71e
   142  Root Key:	3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
   143  ```
   144  ```bash
   145  $ docker trust view example/trust-demo2
   146  SIGNED TAG          DIGEST                                                             SIGNERS
   147  v1                  74d4bfa917d55d53c7df3d2ab20a8d926874d61c3da5ef6de15dd2654fc467c4   bob
   148  
   149  List of signers and their keys:
   150  
   151  SIGNER              KEYS
   152  bob                 5600f5ab76a2
   153  
   154  Administrative keys for example/trust-demo2:
   155  Repository Key:	ece554f14c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4553d2ab20a8d9268
   156  Root Key:	3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
   157  ```
   158  
   159  `docker trust signer remove` removes signers to repositories on a best effort basis, so it will continue to remove the signer from subsequent repositories if one attempt fails:
   160  
   161  ```bash
   162  $ docker trust signer remove alice example/unauthorized example/authorized
   163  Removing signer "alice" from image example/unauthorized...
   164  No signer alice for image example/unauthorized
   165  
   166  Removing signer "alice" from image example/authorized...
   167  Enter passphrase for repository key with ID c6772a0: 
   168  Successfully removed alice from example/authorized
   169  
   170  Error removing signer from: example/unauthorized
   171  ```
   172