{"id":"5a7e55397988a137","repo":"docker/cli","slug":"path-to-a-public-key-must-be-provided-using-the","errorCode":null,"errorMessage":"path to a public key must be provided using the `--key` flag","messagePattern":"path to a public key must be provided using the `--key` flag","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/docker-trust/trust/signer_add.go","lineNumber":60,"sourceCode":"\tflags := cmd.Flags()\n\toptions.keys = opts.NewListOpts(nil)\n\tflags.Var(&options.keys, \"key\", \"Path to the signer's public key file\")\n\treturn cmd\n}\n\nvar validSignerName = lazyregexp.New(`^[a-z0-9][a-z0-9\\_\\-]*$`).MatchString\n\nfunc addSigner(ctx context.Context, dockerCLI command.Cli, options signerAddOptions) error {\n\tsignerName := options.signer\n\tif !validSignerName(signerName) {\n\t\treturn fmt.Errorf(\"signer name \\\"%s\\\" must start with lowercase alphanumeric characters and can include \\\"-\\\" or \\\"_\\\" after the first character\", signerName)\n\t}\n\tif signerName == \"releases\" {\n\t\treturn errors.New(\"releases is a reserved keyword, use a different signer name\")\n\t}\n\n\tif options.keys.Len() == 0 {\n\t\treturn errors.New(\"path to a public key must be provided using the `--key` flag\")\n\t}\n\tsignerPubKeys, err := ingestPublicKeys(options.keys.GetSlice())\n\tif err != nil {\n\t\treturn err\n\t}\n\tvar errRepos []string\n\tfor _, repoName := range options.repos {\n\t\t_, _ = fmt.Fprintf(dockerCLI.Out(), \"Adding signer \\\"%s\\\" to %s...\\n\", signerName, repoName)\n\t\tif err := addSignerToRepo(ctx, dockerCLI, signerName, repoName, signerPubKeys); err != nil {\n\t\t\t_, _ = fmt.Fprintln(dockerCLI.Err(), err.Error()+\"\\n\")\n\t\t\terrRepos = append(errRepos, repoName)\n\t\t} else {\n\t\t\t_, _ = fmt.Fprintf(dockerCLI.Out(), \"Successfully added signer: %s to %s\\n\\n\", signerName, repoName)\n\t\t}\n\t}\n\tif len(errRepos) > 0 {\n\t\treturn fmt.Errorf(\"failed to add signer to: %s\", strings.Join(errRepos, \", \"))\n\t}","sourceCodeStart":42,"sourceCodeEnd":78,"githubUrl":"https://github.com/docker/cli/blob/e9452d6e785f6e365712b9d71bd7517591773c86/cmd/docker-trust/trust/signer_add.go#L42-L78","documentation":"Error \"path to a public key must be provided using the `--key` flag\" thrown in docker/cli.","triggerScenarios":"Thrown at cmd/docker-trust/trust/signer_add.go:60 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"e9452d6e785f6e365712b9d71bd7517591773c86","analyzedAt":"2026-08-01T07:09:22.474Z","schemaVersion":2}