├── content ├── faq │ ├── login_fails.md │ ├── hook_not_received.md │ ├── clone_private_dependencies.md │ ├── maven_home.md │ ├── gradle_home.md │ ├── bundler_home.md │ ├── error-invalid-or-missing-image.md │ ├── error_client_is_newer_than_server.md │ ├── drone_is_broken.md │ ├── error_insufficient_privileges.md │ ├── error_image_not_found.md │ └── error_could_not_read_username_for.md ├── sitemap.md ├── cli │ ├── user │ │ ├── data │ │ │ ├── drone_user_add.out.txt │ │ │ ├── drone_user_rm.out.txt │ │ │ ├── drone_user_ls.out.txt │ │ │ └── drone_user_info.out.txt │ │ ├── drone_user_rm.md │ │ ├── drone_user_add.md │ │ ├── drone_user_rm.zh.md │ │ ├── drone_user_add.zh.md │ │ ├── drone_user_info.md │ │ ├── drone_user_ls.md │ │ ├── drone_user_ls.zh.md │ │ └── drone_user_info.zh.md │ ├── repo │ │ ├── data │ │ │ ├── drone_repo_add.out.txt │ │ │ ├── drone_repo_rm.out.txt │ │ │ ├── drone_repo_repair.out.txt │ │ │ ├── drone_repo_chown.out.txt │ │ │ ├── drone_repo_ls.out.txt │ │ │ ├── drone_repo_info.out.txt │ │ │ └── drone_repo_update.out.txt │ │ ├── drone_repo_add.md │ │ ├── drone_repo_rm.md │ │ ├── drone_repo_repair.md │ │ ├── drone_repo_add.zh.md │ │ ├── drone_repo_rm.zh.md │ │ ├── drone_repo_repair.zh.md │ │ ├── drone_repo_chown.md │ │ ├── drone_repo_chown.zh.md │ │ ├── drone_repo_info.md │ │ ├── drone_repo_info.zh.md │ │ ├── drone_repo_ls.md │ │ ├── drone_repo_ls.zh.md │ │ ├── drone_repo_update.md │ │ └── drone_repo_update.zh.md │ ├── build │ │ ├── data │ │ │ ├── drone_build_stop.out.txt │ │ │ ├── drone_build_logs.out.txt │ │ │ ├── drone_build_approve.out.txt │ │ │ ├── drone_build_decline.out.txt │ │ │ ├── drone_build_kill.out.txt │ │ │ ├── drone_build_start.out.txt │ │ │ ├── drone_build_info.out.txt │ │ │ ├── drone_build_last.out.txt │ │ │ └── drone_build_ls.out.txt │ │ ├── drone_build_list.md │ │ ├── drone_build_info.md │ │ ├── drone_build_last.md │ │ ├── drone_build_list.zh.md │ │ ├── drone_build_logs.md │ │ ├── drone_build_stop.md │ │ ├── drone_build_start.md │ │ ├── drone_build_info.zh.md │ │ ├── drone_build_last.zh.md │ │ ├── drone_build_logs.zh.md │ │ ├── drone_build_stop.zh.md │ │ ├── drone_build_approve.md │ │ ├── drone_build_decline.md │ │ ├── drone_build_start.zh.md │ │ ├── drone_build_approve.zh.md │ │ ├── drone_build_decline.zh.md │ │ └── drone_build_kill.md │ ├── secret │ │ ├── data │ │ │ ├── drone_secret_ls.out.txt │ │ │ ├── drone_secret_rm.out.txt │ │ │ ├── drone_secret_info.out.txt │ │ │ ├── drone_secret_add.out.txt │ │ │ └── drone_secret_update.out.txt │ │ ├── drone_secret_rm.md │ │ ├── drone_secret_rm.zh.md │ │ ├── drone_secret_update.md │ │ ├── drone_secret_info.md │ │ ├── drone_secret_update.zh.md │ │ ├── drone_secret_ls.md │ │ ├── drone_secret_info.zh.md │ │ ├── drone_secret_ls.zh.md │ │ ├── drone_secret_add.md │ │ └── drone_secret_add.zh.md │ ├── registry │ │ ├── data │ │ │ ├── drone_registry_ls.out.txt │ │ │ ├── drone_registry_rm.out.txt │ │ │ ├── drone_registry_info.out.txt │ │ │ ├── drone_registry_add.out.txt │ │ │ └── drone_registry_update.out.txt │ │ ├── drone_registry_info.md │ │ ├── drone_registry_ls.md │ │ ├── drone_registry_info.zh.md │ │ ├── drone_registry_ls.zh.md │ │ ├── drone_registry_update.md │ │ ├── drone_registry_update.zh.md │ │ ├── drone_registry_rm.md │ │ ├── drone_registry_rm.zh.md │ │ ├── drone_registry_add.md │ │ └── drone_registry_add.zh.md │ ├── misc │ │ ├── drone_exec.zh.md │ │ ├── drone_deploy.md │ │ ├── drone_deploy.zh.md │ │ ├── data │ │ │ └── drone_deploy.out.txt │ │ └── drone_exec.md │ ├── cli_authentication.md │ └── cli_authentication.zh.md ├── api │ ├── api_overview.zh.md │ ├── user │ │ ├── user_feed.md │ │ ├── user_repos.md │ │ ├── user_feed.zh.md │ │ ├── user_repos.zh.md │ │ ├── user_info.md │ │ └── user_info.zh.md │ ├── users │ │ ├── users_delete.md │ │ ├── users_list.md │ │ ├── users_info.md │ │ ├── users_update.md │ │ └── users_create.md │ ├── registry │ │ ├── registry_create.md │ │ ├── registry_delete.md │ │ ├── registry_update.md │ │ ├── registry_list.md │ │ └── registry_info.md │ ├── repo │ │ ├── repo_chown.md │ │ ├── repo_repair.md │ │ ├── repo_info.md │ │ ├── repo_list.md │ │ ├── repo_create.md │ │ ├── repo_delete.md │ │ └── repo_update.md │ ├── build │ │ ├── build_stop.md │ │ ├── build_approve.md │ │ ├── build_decline.md │ │ ├── build_info.md │ │ ├── build_list.md │ │ └── build_logs.md │ ├── secret │ │ ├── secret_delete.md │ │ ├── secret_list.md │ │ ├── secret_info.md │ │ ├── secret_create.md │ │ └── secret_update.md │ ├── api_authentication.md │ └── api_overview.md ├── usage │ ├── config │ │ ├── devices.md │ │ ├── networks.md │ │ ├── devices.zh.md │ │ ├── networks.zh.md │ │ ├── privileged.md │ │ ├── privileged.zh.md │ │ ├── images.zh.md │ │ ├── images.md │ │ ├── volumes.md │ │ └── pipeline-conditions.md │ ├── concepts │ │ ├── gating.md │ │ ├── gating.zh.md │ │ ├── cloning.zh.md │ │ ├── plugins.md │ │ └── plugins.zh.md │ ├── reference │ │ ├── yaml.md │ │ └── yaml.zh.md │ ├── deployments │ │ ├── more.md │ │ ├── gke.md │ │ ├── heroku.md │ │ ├── heroku.zh.md │ │ ├── gke.zh.md │ │ ├── more.zh.md │ │ ├── ecs.md │ │ ├── ecs.zh.md │ │ ├── kubernetes.md │ │ └── kubernetes.zh.md │ ├── notifications │ │ ├── more.md │ │ ├── more.zh.md │ │ ├── email.md │ │ ├── email.zh.md │ │ ├── hipchat.md │ │ └── hipchat.zh.md │ ├── publishing │ │ ├── more.md │ │ ├── npm.md │ │ ├── docker.md │ │ ├── more.zh.md │ │ ├── npm.zh.md │ │ ├── s3.md │ │ ├── docker.zh.md │ │ ├── s3.zh.md │ │ ├── gcs.md │ │ ├── gcs.zh.md │ │ ├── gh_pages.md │ │ └── gh_pages.zh.md │ ├── reporting │ │ ├── pdiff.md │ │ ├── pdiff.zh.md │ │ ├── coverage.zh.md │ │ ├── ccmenu.md │ │ ├── testing.zh.md │ │ ├── coverage.md │ │ ├── testing.md │ │ ├── ccmenu.zh.md │ │ ├── badges.md │ │ └── badges.zh.md │ ├── getting_help.ru.md │ ├── getting_help.es.md │ ├── secrets │ │ ├── secrets_global.md │ │ └── registries_global.md │ ├── examples │ │ ├── redis.md │ │ ├── selenium.md │ │ ├── mongo.md │ │ └── node.md │ ├── getting_help.zh.md │ └── getting_help.md ├── plugin │ └── pipeline │ │ ├── plugin_guidelines.zh.md │ │ ├── plugin_guidelines.md │ │ ├── plugin_overview.zh.md │ │ └── plugin_overview.md └── install │ ├── installation_reference.zh.md │ ├── installation_reference.md │ ├── installation_reference.es.md │ ├── server │ ├── ngrok.zh.md │ ├── ngrok.es.md │ ├── ssl.zh.md │ ├── ngrok.md │ ├── apache.md │ ├── apache.es.md │ ├── nginx.es.md │ ├── apache.zh.md │ ├── caddy.zh.md │ ├── caddy.md │ ├── nginx.md │ └── caddy.es.md │ ├── users │ ├── user_admins.es.md │ ├── user_admins.zh.md │ ├── user_management.md │ ├── user_management.es.md │ ├── user_admins.md │ └── user_management.zh.md │ ├── releases │ └── 0.6.0-notes │ │ ├── signature.md │ │ ├── networking.md │ │ ├── cloning.md │ │ ├── cloning.zh.md │ │ ├── signature.zh.md │ │ ├── networking.zh.md │ │ └── gating.md │ ├── installation_help.md │ ├── extensions │ ├── custom_policies.md │ ├── global_environ.md │ └── global_webhooks.md │ ├── installation_help.es.md │ └── installation_help.zh.md ├── themes └── drone │ ├── layouts │ ├── 404.html │ ├── _default │ │ ├── list.html │ │ └── single.html │ ├── partials │ │ ├── footer.html │ │ ├── style_reset.html │ │ ├── page_meta.html │ │ ├── menu_api.html │ │ ├── menu_cli.html │ │ ├── menu_install.html │ │ ├── menu_plugin.html │ │ ├── menu_usage.html │ │ ├── hljs.html │ │ ├── questions.html │ │ ├── next_steps.html │ │ ├── next_prev.html │ │ ├── algolia.html │ │ ├── style.html │ │ ├── languages.html │ │ ├── header.html │ │ └── menu.html │ ├── shortcodes │ │ ├── version.html │ │ ├── cat.html │ │ └── alert.html │ ├── sitemap │ │ └── single.html │ ├── index.html │ ├── api │ │ └── single.html │ ├── cli │ │ └── single.html │ ├── install │ │ └── single.html │ └── plugin │ │ └── single.html │ ├── archetypes │ └── default.md │ ├── static │ ├── favicon.ico │ ├── mstile-70x70.png │ ├── favicon-16x16.png │ ├── favicon-32x32.png │ ├── mstile-144x144.png │ ├── mstile-150x150.png │ ├── mstile-310x150.png │ ├── mstile-310x310.png │ ├── apple-touch-icon.png │ ├── android-chrome-192x192.png │ ├── android-chrome-512x512.png │ ├── browserconfig.xml │ ├── manifest.json │ ├── logo.svg │ └── css │ │ └── reset.css │ ├── theme.toml │ └── LICENSE.md ├── .gitignore ├── static └── images │ ├── coding_oauth.png │ ├── github_oauth.png │ ├── drone_repo_list.png │ ├── drone_user_token.png │ └── drone_build_running.png ├── README.md └── .drone.yml /content/faq/login_fails.md: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /content/faq/hook_not_received.md: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /themes/drone/layouts/404.html: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | public 2 | public/** 3 | -------------------------------------------------------------------------------- /themes/drone/layouts/_default/list.html: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/footer.html: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/style_reset.html: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /themes/drone/archetypes/default.md: -------------------------------------------------------------------------------- 1 | +++ 2 | +++ 3 | -------------------------------------------------------------------------------- /themes/drone/layouts/shortcodes/version.html: -------------------------------------------------------------------------------- 1 | 0.8 2 | -------------------------------------------------------------------------------- /themes/drone/layouts/shortcodes/cat.html: -------------------------------------------------------------------------------- 1 | {{ $path := .Get 0 }} 2 | {{ readFile $path }} 3 | -------------------------------------------------------------------------------- /static/images/coding_oauth.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/static/images/coding_oauth.png -------------------------------------------------------------------------------- /static/images/github_oauth.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/static/images/github_oauth.png -------------------------------------------------------------------------------- /themes/drone/static/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/favicon.ico -------------------------------------------------------------------------------- /static/images/drone_repo_list.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/static/images/drone_repo_list.png -------------------------------------------------------------------------------- /themes/drone/layouts/partials/page_meta.html: -------------------------------------------------------------------------------- 1 |

2 |

{{ i18n "page_meta" .File | markdownify }}

3 | -------------------------------------------------------------------------------- /static/images/drone_user_token.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/static/images/drone_user_token.png -------------------------------------------------------------------------------- /themes/drone/static/mstile-70x70.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/mstile-70x70.png -------------------------------------------------------------------------------- /static/images/drone_build_running.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/static/images/drone_build_running.png -------------------------------------------------------------------------------- /themes/drone/static/favicon-16x16.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/favicon-16x16.png -------------------------------------------------------------------------------- /themes/drone/static/favicon-32x32.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/favicon-32x32.png -------------------------------------------------------------------------------- /themes/drone/static/mstile-144x144.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/mstile-144x144.png -------------------------------------------------------------------------------- /themes/drone/static/mstile-150x150.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/mstile-150x150.png -------------------------------------------------------------------------------- /themes/drone/static/mstile-310x150.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/mstile-310x150.png -------------------------------------------------------------------------------- /themes/drone/static/mstile-310x310.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/mstile-310x310.png -------------------------------------------------------------------------------- /themes/drone/layouts/partials/menu_api.html: -------------------------------------------------------------------------------- 1 | {{ partial "menu.html" (dict "menu" .Site.Menus.api "page" . "site" .Site) }} 2 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/menu_cli.html: -------------------------------------------------------------------------------- 1 | {{ partial "menu.html" (dict "menu" .Site.Menus.cli "page" . "site" .Site) }} 2 | -------------------------------------------------------------------------------- /themes/drone/layouts/shortcodes/alert.html: -------------------------------------------------------------------------------- 1 | 4 | -------------------------------------------------------------------------------- /themes/drone/static/apple-touch-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/apple-touch-icon.png -------------------------------------------------------------------------------- /themes/drone/layouts/partials/menu_install.html: -------------------------------------------------------------------------------- 1 | {{ partial "menu.html" (dict "menu" .Site.Menus.install "page" . "site" .Site) }} 2 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/menu_plugin.html: -------------------------------------------------------------------------------- 1 | {{ partial "menu.html" (dict "menu" .Site.Menus.plugin "page" . "site" .Site) }} 2 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/menu_usage.html: -------------------------------------------------------------------------------- 1 | {{ partial "menu.html" (dict "menu" .Site.Menus.usage "page" . "site" .Site) }} 2 | -------------------------------------------------------------------------------- /content/sitemap.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Sitemap" 4 | url = "sitemap" 5 | type = "sitemap" 6 | +++ 7 | -------------------------------------------------------------------------------- /themes/drone/static/android-chrome-192x192.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/android-chrome-192x192.png -------------------------------------------------------------------------------- /themes/drone/static/android-chrome-512x512.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zen/docs/master/themes/drone/static/android-chrome-512x512.png -------------------------------------------------------------------------------- /content/cli/user/data/drone_user_add.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone user add - adds a user 3 | 4 | USAGE: 5 | drone user add [arguments...] 6 | -------------------------------------------------------------------------------- /content/cli/user/data/drone_user_rm.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone user rm - remove a user 3 | 4 | USAGE: 5 | drone user rm [arguments...] 6 | -------------------------------------------------------------------------------- /content/cli/repo/data/drone_repo_add.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone repo add - add a repository 3 | 4 | USAGE: 5 | drone repo add [arguments...] 6 | -------------------------------------------------------------------------------- /content/cli/repo/data/drone_repo_rm.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone repo rm - remove a repository 3 | 4 | USAGE: 5 | drone repo rm [arguments...] 6 | -------------------------------------------------------------------------------- /content/cli/build/data/drone_build_stop.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone build stop - stop a build 3 | 4 | USAGE: 5 | drone build stop [arguments...] 6 | -------------------------------------------------------------------------------- /content/cli/build/data/drone_build_logs.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone build logs - show build logs 3 | 4 | USAGE: 5 | drone build logs [arguments...] 6 | -------------------------------------------------------------------------------- /content/faq/clone_private_dependencies.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | https://stackoverflow.com/questions/4891527/git-protocol-blocked-by-company-how-can-i-get-around-that 4 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/hljs.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | -------------------------------------------------------------------------------- /content/cli/build/data/drone_build_approve.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone build approve - approve a build 3 | 4 | USAGE: 5 | drone build approve [arguments...] 6 | -------------------------------------------------------------------------------- /content/cli/build/data/drone_build_decline.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone build decline - decline a build 3 | 4 | USAGE: 5 | drone build decline [arguments...] 6 | -------------------------------------------------------------------------------- /content/cli/build/data/drone_build_kill.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone build kill - force kill a build 3 | 4 | USAGE: 5 | drone build kill 6 | -------------------------------------------------------------------------------- /content/cli/repo/data/drone_repo_repair.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone repo repair - repair repository webhooks 3 | 4 | USAGE: 5 | drone repo repair [arguments...] 6 | -------------------------------------------------------------------------------- /content/cli/repo/data/drone_repo_chown.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone repo chown - assume ownership of a repository 3 | 4 | USAGE: 5 | drone repo chown [arguments...] 6 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/questions.html: -------------------------------------------------------------------------------- 1 | {{ if not .Params.questions_off }} 2 |

{{ i18n "questions" }}

3 |

{{ i18n "questions_text" | markdownify }}

4 | {{ end }} 5 | -------------------------------------------------------------------------------- /themes/drone/theme.toml: -------------------------------------------------------------------------------- 1 | name = "drone-theme" 2 | license = "BSD" 3 | min_version = "0.20" 4 | 5 | [author] 6 | name = "bradrydzewski" 7 | homepage = "https://github.com/bradrydzewski" 8 | -------------------------------------------------------------------------------- /content/api/api_overview.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:05" 3 | title = "API 概述" 4 | url = "zh/api-overview" 5 | 6 | [menu.api] 7 | weight = 1 8 | identifier = "api-overview-zh" 9 | parent = "api_overview" 10 | +++ 11 | -------------------------------------------------------------------------------- /content/cli/user/data/drone_user_ls.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone user ls - list all users 3 | 4 | USAGE: 5 | drone user ls [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --format value format output (default: "{{ .Login }}") 9 | 10 | -------------------------------------------------------------------------------- /content/usage/config/devices.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Devices" 4 | url = "docker-devices" 5 | draft = true 6 | 7 | [menu.usage] 8 | weight = 5 9 | identifier = "devices" 10 | parent = "usage_config" 11 | +++ 12 | -------------------------------------------------------------------------------- /content/plugin/pipeline/plugin_guidelines.zh.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2016-01-01T00:00:00+00:00 3 | title: "插件指南" 4 | url: zh/plugin-guidelines 5 | weight: 2 6 | 7 | menu: 8 | plugin: 9 | parent: pipeline 10 | identifier: plugin-guidelines-zh 11 | --- 12 | -------------------------------------------------------------------------------- /content/usage/config/networks.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Networks" 4 | url = "docker-networks" 5 | draft = true 6 | 7 | [menu.usage] 8 | weight = 6 9 | identifier = "networks" 10 | parent = "usage_config" 11 | +++ 12 | -------------------------------------------------------------------------------- /content/cli/secret/data/drone_secret_ls.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone secret ls - list secrets 3 | 4 | USAGE: 5 | drone secret ls [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | 10 | -------------------------------------------------------------------------------- /content/usage/config/devices.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Devices 设备" 4 | url = "zh/docker-devices" 5 | draft = true 6 | 7 | [menu.usage] 8 | weight = 5 9 | identifier = "devices-zh" 10 | parent = "usage_config" 11 | +++ 12 | -------------------------------------------------------------------------------- /content/usage/config/networks.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Networks 网络" 4 | url = "zh/docker-networks" 5 | draft = true 6 | 7 | [menu.usage] 8 | weight = 6 9 | identifier = "networks-zh" 10 | parent = "usage_config" 11 | +++ 12 | -------------------------------------------------------------------------------- /content/cli/registry/data/drone_registry_ls.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone registry ls - list regitries 3 | 4 | USAGE: 5 | drone registry ls [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | 10 | -------------------------------------------------------------------------------- /content/cli/user/data/drone_user_info.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone user info - show user details 3 | 4 | USAGE: 5 | drone user info [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --format value format output (default: "User: {{ .Login }}\nEmail: {{ .Email }}") 9 | 10 | -------------------------------------------------------------------------------- /content/faq/maven_home.md: -------------------------------------------------------------------------------- 1 | 2 | ```diff 3 | pipeline: 4 | build: 5 | image: maven 6 | commands: 7 | - mvn install 8 | - mvn package 9 | environment: 10 | + - MAVEN_HOME=/drone/.m2 11 | + - M2_HOME=/drone/.m2 12 | + - GRADLE_USER_HOME=/drone/.gradle 13 | ``` 14 | -------------------------------------------------------------------------------- /content/install/installation_reference.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "安装参考" 4 | url = "zh/installation-reference" 5 | draft = true 6 | 7 | [menu.install] 8 | weight = 2 9 | identifier = "installation-reference-zh" 10 | parent = "install_overview" 11 | +++ 12 | -------------------------------------------------------------------------------- /content/cli/repo/data/drone_repo_ls.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone repo ls - list all repos 3 | 4 | USAGE: 5 | drone repo ls [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --format value format output (default: "{{ .FullName }}") 9 | --org value filter by organization 10 | 11 | -------------------------------------------------------------------------------- /content/faq/gradle_home.md: -------------------------------------------------------------------------------- 1 | 2 | ```diff 3 | pipeline: 4 | build: 5 | image: maven 6 | commands: 7 | - mvn install 8 | - mvn package 9 | environment: 10 | + - MAVEN_HOME=/drone/.m2 11 | + - M2_HOME=/drone/.m2 12 | + - GRADLE_USER_HOME=/drone/.gradle 13 | ``` 14 | -------------------------------------------------------------------------------- /content/cli/secret/data/drone_secret_rm.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone secret rm - remove a secret 3 | 4 | USAGE: 5 | drone secret rm [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | --name value secret name 10 | 11 | -------------------------------------------------------------------------------- /content/faq/bundler_home.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | ```diff 5 | pipeline: 6 | build: 7 | image: ruby 8 | commands: 9 | - bundler install 10 | environment: 11 | + - GEM_HOME= 12 | + - GEM_PATH= 13 | + - BUNDLE_PATH= 14 | + - BUNDLE_BIN= 15 | + - BUNDLE_CACHE_PATH= 16 | ``` 17 | -------------------------------------------------------------------------------- /content/install/installation_reference.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Installation Reference" 4 | url = "installation-reference" 5 | draft = true 6 | 7 | [menu.install] 8 | weight = 2 9 | identifier = "installation-reference" 10 | parent = "install_overview" 11 | +++ 12 | -------------------------------------------------------------------------------- /content/usage/concepts/gating.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Gated Builds" 4 | url = "gated-builds" 5 | 6 | [menu.usage] 7 | weight = 11 8 | identifier = "gated-builds" 9 | parent = "usage_concepts" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/cli/secret/data/drone_secret_info.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone secret info - display secret info 3 | 4 | USAGE: 5 | drone secret info [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | --name value secret name 10 | 11 | -------------------------------------------------------------------------------- /content/install/installation_reference.es.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Referencia de instalación" 4 | url = "es/installation-reference" 5 | draft = true 6 | 7 | [menu.install] 8 | weight = 2 9 | identifier = "installation-reference-es" 10 | parent = "install_overview" 11 | +++ 12 | -------------------------------------------------------------------------------- /content/usage/concepts/gating.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "门禁构建" 4 | url = "zh/gated-builds" 5 | 6 | [menu.usage] 7 | weight = 11 8 | identifier = "gated-builds-zh" 9 | parent = "usage_concepts" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/reference/yaml.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Reference Yaml" 4 | url = "yaml-reference" 5 | 6 | [menu.usage] 7 | weight = 1 8 | parent = "usage_reference" 9 | identifier = "yaml-reference" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/next_steps.html: -------------------------------------------------------------------------------- 1 | {{ if .Params.next_steps }} 2 |

{{ i18n "next_steps" }}

3 | 11 | {{ end }} 12 | -------------------------------------------------------------------------------- /content/cli/misc/drone_exec.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone exec" 4 | url = "zh/cli-exec" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-exec-zh" 9 | parent = "cli_misc" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/misc/data/drone_exec.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/install/server/ngrok.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Ngrok 配置" 4 | url = "zh/setup-with-ngrok" 5 | 6 | [menu.install] 7 | identifier = "setup-with-ngrok-zh" 8 | parent = "install_server" 9 | weight = 6 10 | +++ 11 | 12 | {{% alert warn %}} 13 | 对应步骤暂未更新 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/reference/yaml.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Yaml 参考文档" 4 | url = "zh/yaml-reference" 5 | 6 | [menu.usage] 7 | weight = 1 8 | parent = "usage_reference" 9 | identifier = "yaml-reference-zh" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /themes/drone/static/browserconfig.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | #9f00a7 7 | 8 | 9 | 10 | -------------------------------------------------------------------------------- /content/usage/deployments/more.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "More" 4 | url = "other-deployment-types" 5 | 6 | [menu.usage] 7 | weight = 4 8 | identifier = "other-deployment-types" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/cli/misc/drone_deploy.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone deploy" 4 | url = "cli-deploy" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-deploy" 9 | parent = "cli_misc" 10 | +++ 11 | 12 | 13 | ```text 14 | {{< cat "content/cli/misc/data/drone_deploy.out.txt" >}} 15 | ``` 16 | -------------------------------------------------------------------------------- /content/usage/deployments/gke.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Deploy to Google GKE" 4 | url = "deploy-to-google-gke" 5 | 6 | [menu.usage] 7 | weight = 3 8 | identifier = "deploy-to-gke" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/deployments/heroku.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Deploy to Heroku" 4 | url = "deploy-to-heroku" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "deploy-to-heroku" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/deployments/heroku.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "部署到 Heroku" 4 | url = "zh/deploy-to-heroku" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "deploy-to-heroku-zh" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_list.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build ls" 4 | url = "cli-build-ls" 5 | 6 | [menu.cli] 7 | weight = 6 8 | identifier = "cli-build-ls" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_ls.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/misc/drone_deploy.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone deploy" 4 | url = "zh/cli-deploy" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-deploy-zh" 9 | parent = "cli_misc" 10 | +++ 11 | 12 | 13 | ```text 14 | {{< cat "content/cli/misc/data/drone_deploy.out.txt" >}} 15 | ``` 16 | -------------------------------------------------------------------------------- /content/usage/deployments/gke.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "部署到 Google GKE" 4 | url = "zh/deploy-to-google-gke" 5 | 6 | [menu.usage] 7 | weight = 3 8 | identifier = "deploy-to-gke-zh" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/deployments/more.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "更多" 4 | url = "zh/other-deployment-types" 5 | 6 | [menu.usage] 7 | weight = 4 8 | identifier = "other-deployment-types-zh" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/notifications/more.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "More" 4 | url = "other-notification-types" 5 | 6 | [menu.usage] 7 | weight = 4 8 | identifier = "other-notification-types" 9 | parent = "usage_notifications" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/more.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "More" 4 | url = "publishing-to-github-pages" 5 | 6 | [menu.usage] 7 | weight = 6 8 | identifier = "publishing-to-github-pages" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/npm.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Publish Node Modules" 4 | url = "publish-node-modules" 5 | 6 | [menu.usage] 7 | weight = 2 8 | identifier = "publish-node-modules" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/deployments/ecs.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Deploy to Amazon ECS" 4 | url = "deploy-to-amazon-ecs" 5 | 6 | [menu.usage] 7 | weight = 3 8 | identifier = "deploy-to-amazon-ecs" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/deployments/ecs.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "部署到 Amazon ECS" 4 | url = "zh/deploy-to-amazon-ecs" 5 | 6 | [menu.usage] 7 | weight = 3 8 | identifier = "deploy-to-amazon-ecs-zh" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/notifications/more.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "更多" 4 | url = "zh-other-notification-types" 5 | 6 | [menu.usage] 7 | weight = 4 8 | identifier = "other-notification-types-zh" 9 | parent = "usage_notifications" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/docker.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Publish Docker Images" 4 | url = "publish-docker-images" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "publish-docker-images" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/more.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "更多" 4 | url = "zh/publishing-to-github-pages" 5 | 6 | [menu.usage] 7 | weight = 6 8 | identifier = "publishing-to-github-pages-zh" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/npm.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "发布到 Node Modules" 4 | url = "zh/publish-node-modules" 5 | 6 | [menu.usage] 7 | weight = 2 8 | identifier = "publish-node-modules-zh" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/s3.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Publish to Amazon S3" 4 | url = "publish-artifacts-to-s3" 5 | 6 | [menu.usage] 7 | weight = 3 8 | identifier = "publish-artifacts-to-s3" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build info" 4 | url = "cli-build-info" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-build-info" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_info.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_last.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build last" 4 | url = "cli-build-last" 5 | 6 | [menu.cli] 7 | weight = 5 8 | identifier = "cli-build-last" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_last.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_list.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build ls" 4 | url = "zh/cli-build-ls" 5 | 6 | [menu.cli] 7 | weight = 6 8 | identifier = "cli-build-ls-zh" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_ls.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_logs.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build logs" 4 | url = "cli-build-logs" 5 | 6 | [menu.cli] 7 | weight = 7 8 | identifier = "cli-build-logs" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_logs.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_stop.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build stop" 4 | url = "cli-build-stop" 5 | 6 | [menu.cli] 7 | weight = 9 8 | identifier = "cli-build-stop" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_stop.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/registry/data/drone_registry_rm.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone registry rm - remove a registry 3 | 4 | USAGE: 5 | drone registry rm [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | --hostname value registry hostname (default: "docker.io") 10 | 11 | -------------------------------------------------------------------------------- /content/usage/deployments/kubernetes.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Deploy to Kubernetes" 4 | url = "deploy-to-kubernetes" 5 | 6 | [menu.usage] 7 | weight = 2 8 | identifier = "deploy-to-kubernetes" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/docker.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "发布到 Docker 镜像" 4 | url = "zh/publish-docker-images" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "publish-docker-images-zh" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/s3.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "发布到 Amazon S3" 4 | url = "zh/publish-artifacts-to-s3" 5 | 6 | [menu.usage] 7 | weight = 3 8 | identifier = "publish-artifacts-to-s3-zh" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_start.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build start" 4 | url = "cli-build-start" 5 | 6 | [menu.cli] 7 | weight = 8 8 | identifier = "cli-build-start" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_start.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/usage/deployments/kubernetes.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "部署到 Kubernetes" 4 | url = "zh/deploy-to-kubernetes" 5 | 6 | [menu.usage] 7 | weight = 2 8 | identifier = "deploy-to-kubernetes-zh" 9 | parent = "usage_deployments" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/notifications/email.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Sending Emails" 4 | url = "trigger-email-notifications" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "trigger-email-notifications" 9 | parent = "usage_notifications" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/gcs.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Publish to Google Storage" 4 | url = "publish-artifacts-to-gcs" 5 | 6 | [menu.usage] 7 | weight = 4 8 | identifier = "publish-artifacts-to-gcs" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/gcs.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "发布到 Google Storage" 4 | url = "zh/publish-artifacts-to-gcs" 5 | 6 | [menu.usage] 7 | weight = 4 8 | identifier = "publish-artifacts-to-gcs-zh" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/gh_pages.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Publish to GitHub Pages" 4 | url = "publish-to-github-pages" 5 | 6 | [menu.usage] 7 | weight = 5 8 | identifier = "publish-to-github-pages" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/publishing/gh_pages.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "发布到 GitHub Pages" 4 | url = "zh/publish-to-github-pages" 5 | 6 | [menu.usage] 7 | weight = 5 8 | identifier = "publish-to-github-pages-zh" 9 | parent = "usage_publishing" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/cli/build/data/drone_build_start.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone build start - start a build 3 | 4 | USAGE: 5 | drone build start [command options] {repo} {build} 6 | 7 | OPTIONS: 8 | --fork fork the build 9 | --param value, -p value custom parameters to be injected into the job environment. Format: KEY=value 10 | 11 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_info.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build info" 4 | url = "zh/cli-build-info" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-build-info-zh" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_info.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_last.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build last" 4 | url = "zh/cli-build-last" 5 | 6 | [menu.cli] 7 | weight = 5 8 | identifier = "cli-build-last-zh" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_last.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_logs.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build logs" 4 | url = "zh/cli-build-logs" 5 | 6 | [menu.cli] 7 | weight = 7 8 | identifier = "cli-build-logs-zh" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_logs.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_stop.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build stop" 4 | url = "zh/cli-build-stop" 5 | 6 | [menu.cli] 7 | weight = 9 8 | identifier = "cli-build-stop-zh" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_stop.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/registry/data/drone_registry_info.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone registry info - display registry info 3 | 4 | USAGE: 5 | drone registry info [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | --hostname value registry hostname (default: "docker.io") 10 | 11 | -------------------------------------------------------------------------------- /content/install/server/ngrok.es.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Configuración con Ngrok" 4 | url = "es/setup-with-ngrok" 5 | 6 | [menu.install] 7 | identifier = "setup-with-ngrok-es" 8 | parent = "install_server" 9 | weight = 6 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Instrucciones próximamente 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/notifications/email.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "发送到 Emails" 4 | url = "zh/trigger-email-notifications" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "trigger-email-notifications-zh" 9 | parent = "usage_notifications" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/reporting/pdiff.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:03" 3 | title = "Publish Pdiff Results" 4 | url = "publish-pdiff-results" 5 | draft = true 6 | 7 | [menu.usage] 8 | weight = 1 9 | parent = "usage_reports" 10 | identifier = "publish-pdiff-results" 11 | +++ 12 | 13 | {{% alert warn %}} 14 | Coming Soon 15 | {{% /alert %}} 16 | -------------------------------------------------------------------------------- /content/usage/reporting/pdiff.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:03" 3 | title = "发布 Pdiff 结果" 4 | url = "zh/publish-pdiff-results" 5 | draft = true 6 | 7 | [menu.usage] 8 | weight = 1 9 | parent = "usage_reports" 10 | identifier = "publish-pdiff-results-zh" 11 | +++ 12 | 13 | {{% alert warn %}} 14 | Coming Soon 15 | {{% /alert %}} 16 | -------------------------------------------------------------------------------- /content/api/user/user_feed.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Current User Feed" 4 | url = "api-user-feed" 5 | 6 | [menu.api] 7 | weight = 2 8 | identifier = "api-user-feed" 9 | parent = "api_user" 10 | +++ 11 | 12 | Returns the currently authenticated user's activity feed. 13 | 14 | ```text 15 | GET /api/user/feed 16 | ``` 17 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_approve.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build approve" 4 | url = "cli-build-approve" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-build-approve" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_approve.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_decline.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build decline" 4 | url = "cli-build-decline" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-build-decline" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_decline.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_start.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build start" 4 | url = "zh/cli-build-start" 5 | 6 | [menu.cli] 7 | weight = 8 8 | identifier = "cli-build-start-zh" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_start.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/api/user/user_repos.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Current User Repos" 4 | url = "api-user-repos" 5 | 6 | [menu.api] 7 | weight = 3 8 | identifier = "api-user-repos" 9 | parent = "api_user" 10 | +++ 11 | 12 | Returns the currently authenticated user's repository list. 13 | 14 | ```text 15 | GET /api/user/repos 16 | ``` 17 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_approve.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build approve" 4 | url = "zh/cli-build-approve" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-build-approve-zh" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_approve.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_decline.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build decline" 4 | url = "zh/cli-build-decline" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-build-decline-zh" 9 | parent = "cli_build" 10 | +++ 11 | 12 | ```text 13 | {{< cat "content/cli/build/data/drone_build_decline.out.txt" >}} 14 | ``` 15 | -------------------------------------------------------------------------------- /content/usage/notifications/hipchat.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Sending Hipchat Messages" 4 | url = "trigger-hipchat-notifications" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "trigger-hipchat-notifications" 9 | parent = "usage_notifications" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /content/usage/notifications/hipchat.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "发送到 Hipchat Messages" 4 | url = "zh/trigger-hipchat-notifications" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "trigger-hipchat-notifications-zh" 9 | parent = "usage_notifications" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | Coming Soon 14 | {{% /alert %}} 15 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/next_prev.html: -------------------------------------------------------------------------------- 1 | {{ if .PrevInSection }} 2 | 5 | {{ end }} 6 | {{ if .NextInSection }} 7 | 10 | {{ end }} 11 | -------------------------------------------------------------------------------- /content/api/user/user_feed.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "当前用户信息流" 4 | url = "zh/api-user-feed" 5 | 6 | [menu.api] 7 | weight = 2 8 | identifier = "api-user-feed-zh" 9 | parent = "api_user" 10 | +++ 11 | 12 | 13 | 14 | 返回当前登录用户的活动信息流 15 | 16 | ```text 17 | GET /api/user/feed 18 | ``` 19 | -------------------------------------------------------------------------------- /content/api/users/users_delete.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "User Delete" 4 | url = "api-users-delete" 5 | 6 | [menu.api] 7 | weight = 3 8 | identifier = "api-users-delete" 9 | parent = "api_users" 10 | +++ 11 | 12 | Deletes a user. 13 | Please note this api requires administrative privileges. 14 | 15 | ```text 16 | DELETE /api/users/{login} 17 | ``` 18 | -------------------------------------------------------------------------------- /content/api/user/user_repos.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "当前用户仓库" 4 | url = "zh/api-user-repos" 5 | 6 | [menu.api] 7 | weight = 3 8 | identifier = "api-user-repos-zh" 9 | parent = "api_user" 10 | +++ 11 | 12 | 13 | 14 | 返回当前登录用户的仓库列表。 15 | 16 | ```text 17 | GET /api/user/repos 18 | ``` 19 | -------------------------------------------------------------------------------- /content/usage/reporting/coverage.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:04" 3 | title = "发布 测试覆盖 报告" 4 | url = "zh/publish-coverage-reports" 5 | 6 | [menu.usage] 7 | weight = 1 8 | parent = "usage_reports" 9 | identifier = "publish-coverage-reports-zh" 10 | +++ 11 | 12 | {{% alert warn %}} 13 | [Enterprise Edition 企业版特性](https://drone.io/enterprise/) 14 | {{% /alert %}} 15 | 16 | 这个特性暂未公开 17 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/algolia.html: -------------------------------------------------------------------------------- 1 | {{ if .Site.Params.algolia_key }} 2 | 3 | 10 | {{ end }} 11 | -------------------------------------------------------------------------------- /content/api/registry/registry_create.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Registry Create" 4 | url = "api-registry-add" 5 | 6 | [menu.api] 7 | weight = 1 8 | identifier = "api-registry-add" 9 | parent = "api_registry" 10 | +++ 11 | 12 | Adds a registry. 13 | Please note this api requires write access to the repository. 14 | 15 | ```text 16 | POST /api/repos/{owner}/{repo}/registry 17 | ``` 18 | -------------------------------------------------------------------------------- /content/install/server/ssl.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "SSL 配置" 4 | url = "zh/configure-ssl" 5 | 6 | [menu.install] 7 | identifier = "configure-ssl-zh" 8 | parent = "install_server" 9 | weight = 9 10 | +++ 11 | 12 | 13 | 14 | {{% alert warn %}} 15 | 对应步骤暂未更新，请参考源代码了解有关细节。 16 | {{% /alert %}} 17 | -------------------------------------------------------------------------------- /content/cli/build/data/drone_build_info.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone build info - show build details 3 | 4 | USAGE: 5 | drone build info [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --format value format output (default: "Number: {{ .Number }}\nStatus: {{ .Status }}\nEvent: {{ .Event }}\nCommit: {{ .Commit }}\nBranch: {{ .Branch }}\nRef: {{ .Ref }}\nMessage: {{ .Message }}\nAuthor: {{ .Author }}\n") 9 | 10 | -------------------------------------------------------------------------------- /content/cli/registry/data/drone_registry_add.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone registry add - adds a registry 3 | 4 | USAGE: 5 | drone registry add [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | --hostname value registry hostname (default: "docker.io") 10 | --username value registry username 11 | --password value registry password 12 | 13 | -------------------------------------------------------------------------------- /content/api/repo/repo_chown.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Repo Chown" 4 | url = "api-repo-chown" 5 | 6 | [menu.api] 7 | weight = 4 8 | identifier = "api-repo-chown" 9 | parent = "api_repo" 10 | +++ 11 | 12 | Lets a user assume ownership of a named repository. 13 | Please note this api requires administrative access to the repository. 14 | 15 | ```text 16 | POST /api/repos/{owner}/{repo}/chown 17 | ``` 18 | -------------------------------------------------------------------------------- /content/cli/registry/data/drone_registry_update.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone registry update - update a registry 3 | 4 | USAGE: 5 | drone registry update [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | --hostname value registry hostname (default: "docker.io") 10 | --username value registry username 11 | --password value registry password 12 | 13 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/style.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | -------------------------------------------------------------------------------- /content/cli/repo/data/drone_repo_info.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone repo info - show repository details 3 | 4 | USAGE: 5 | drone repo info [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --format value format output (default: "Owner: {{ .Owner }}\nRepo: {{ .Name }}\nType: {{ .Kind }}\nConfig: {{ .Config }}\nVisibility: {{ .Visibility }}\nPrivate: {{ .IsPrivate }}\nTrusted: {{ .IsTrusted }}\nGated: {{ .IsGated }}\nRemote: {{ .Clone }}\n") 9 | 10 | -------------------------------------------------------------------------------- /content/cli/secret/data/drone_secret_add.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone secret add - adds a secret 3 | 4 | USAGE: 5 | drone secret add [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | --name value secret name 10 | --value value secret value 11 | --event value secret limited to these events 12 | --image value secret limited to these images 13 | 14 | -------------------------------------------------------------------------------- /content/cli/secret/data/drone_secret_update.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone secret update - update a secret 3 | 4 | USAGE: 5 | drone secret update [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --repository value repository name (e.g. octocat/hello-world) 9 | --name value secret name 10 | --value value secret value 11 | --event value secret limited to these events 12 | --image value secret limited to these images 13 | 14 | -------------------------------------------------------------------------------- /content/cli/build/data/drone_build_last.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone build last - show latest build details 3 | 4 | USAGE: 5 | drone build last [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --format value format output (default: "Number: {{ .Number }}\nStatus: {{ .Status }}\nEvent: {{ .Event }}\nCommit: {{ .Commit }}\nBranch: {{ .Branch }}\nRef: {{ .Ref }}\nMessage: {{ .Message }}\nAuthor: {{ .Author }}\n") 9 | --branch value branch name (default: "master") 10 | 11 | -------------------------------------------------------------------------------- /content/usage/reporting/ccmenu.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:01" 3 | title = "CCMenu" 4 | url = "ccmenu" 5 | 6 | [menu.usage] 7 | weight = 4 8 | identifier = "ccmenu" 9 | parent = "usage_reports" 10 | +++ 11 | 12 | Drone has integrated support for [ccmenu](http://ccmenu.org/) monitoring to display the status of your repository in osx or windows menu bar. 13 | 14 | CC endpoint: 15 | 16 | ```text 17 | :///api/badges///cc.xml 18 | ``` 19 | -------------------------------------------------------------------------------- /content/api/build/build_stop.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Build Stop" 4 | url = "api-build-stop" 5 | 6 | [menu.api] 7 | weight = 2 8 | identifier = "api-build-stop" 9 | parent = "api_build" 10 | +++ 11 | 12 | Stop the specified build. 13 | Please note this api requires administrative privileges and the request parameter `{build}` is not the build id but the build number. 14 | 15 | ```text 16 | DELETE /api/repos/{owner}/{repo}/builds/{build} 17 | ``` 18 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/languages.html: -------------------------------------------------------------------------------- 1 | {{- $lang := .Lang }} 2 | {{- $base := .Site.BaseURL }} 3 |
4 | 5 | 6 |
7 | 14 |
15 |
16 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # docs 2 | 3 | [![Build Status](https://beta.drone.io/api/badges/drone/docs/status.svg)](https://beta.drone.io/drone/docs) 4 | 5 | This repository contains the source for [docs.drone.io](http://docs.drone.io). 6 | To generate the documentation you will need to download and install the [hugo](https://gohugo.io/overview/installing/) static website engine. 7 | 8 | Generate and serve the documentation at `localhost:1313`: 9 | 10 | ``` 11 | hugo server -b localhost:1313 -w 12 | ``` 13 | -------------------------------------------------------------------------------- /content/usage/reporting/testing.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "发布 单元测试 结果" 4 | url = "zh/publish-unit-test-results" 5 | 6 | [menu.usage] 7 | weight = 1 8 | parent = "usage_reports" 9 | identifier = "publish-unit-test-results-zh" 10 | +++ 11 | 12 | {{% alert enterprise %}} 13 | [Enterprise Edition 企业版特性](https://drone.io/enterprise/) 14 | {{% /alert %}} 15 | 16 | 17 | 18 | 这个特性暂未公开 19 | -------------------------------------------------------------------------------- /content/cli/build/drone_build_kill.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone build kill" 4 | url = "cli-build-kill" 5 | 6 | [menu.cli] 7 | weight = 4 8 | identifier = "cli-build-kill" 9 | parent = "cli_build" 10 | +++ 11 | 12 | This subcommand lets a user terminate a build that cannot be cancelled. Please note this command requires administrative access to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/build/data/drone_build_kill.out.txt" >}} 16 | ``` 17 | -------------------------------------------------------------------------------- /content/api/registry/registry_delete.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Registry Delete" 4 | url = "api-registry-delete" 5 | 6 | [menu.api] 7 | weight = 3 8 | identifier = "api-registry-delete" 9 | parent = "api_registry" 10 | +++ 11 | 12 | Removes a registry. 13 | Please note this api requires write access to the repository, 14 | and the request parameter `{registry}` is the registry address. 15 | 16 | ```text 17 | DELETE /api/repos/{owner}/{repo}/registry/{registry} 18 | ``` 19 | -------------------------------------------------------------------------------- /content/api/registry/registry_update.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Registry Update" 4 | url = "api-registry-update" 5 | 6 | [menu.api] 7 | weight = 2 8 | identifier = "api-registry-update" 9 | parent = "api_registry" 10 | +++ 11 | 12 | Updates a registry. 13 | Please note this api requires write access to the repository, 14 | and the request parameter `{registry}` is the registry address. 15 | 16 | ```text 17 | PATCH /api/repos/{owner}/{repo}/registry/{registry} 18 | ``` 19 | -------------------------------------------------------------------------------- /content/install/server/ngrok.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Setup with Ngrok" 4 | url = "setup-with-ngrok" 5 | 6 | [menu.install] 7 | identifier = "setup-with-ngrok" 8 | parent = "install_server" 9 | weight = 6 10 | +++ 11 | 12 | After installing [ngrok](https://ngrok.com/), open a new console and run: 13 | 14 | ``` 15 | ngrok http 80 16 | ``` 17 | 18 | Set `DRONE_HOST` (for example in `docker-compose.yml`) to the ngrok url (usually xxx.ngrok.io) and start the server. 19 | -------------------------------------------------------------------------------- /themes/drone/static/manifest.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "drone", 3 | "icons": [ 4 | { 5 | "src": "/android-chrome-192x192.png", 6 | "sizes": "192x192", 7 | "type": "image/png" 8 | }, 9 | { 10 | "src": "/android-chrome-512x512.png", 11 | "sizes": "512x512", 12 | "type": "image/png" 13 | } 14 | ], 15 | "theme_color": "#333333", 16 | "background_color": "#333333", 17 | "display": "standalone" 18 | } -------------------------------------------------------------------------------- /content/usage/reporting/coverage.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:04" 3 | title = "Publish Coverage Results" 4 | url = "publish-coverage-reports" 5 | 6 | [menu.usage] 7 | weight = 1 8 | parent = "usage_reports" 9 | identifier = "publish-coverage-reports" 10 | +++ 11 | 12 | {{% alert enterprise %}} 13 | This feature is only available in the [Enterprise expansion pack](https://drone.io/enterprise/) 14 | {{% /alert %}} 15 | 16 | This feature is not yet available for general use. Check back soon. 17 | -------------------------------------------------------------------------------- /content/usage/reporting/testing.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Publish Unit Test Results" 4 | url = "publish-unit-test-results" 5 | 6 | [menu.usage] 7 | weight = 1 8 | parent = "usage_reports" 9 | identifier = "publish-unit-test-results" 10 | +++ 11 | 12 | {{% alert enterprise %}} 13 | This feature is only available in the [Enterprise expansion pack](https://drone.io/enterprise/) 14 | {{% /alert %}} 15 | 16 | This feature is not yet available for general use. Check back soon. 17 | -------------------------------------------------------------------------------- /content/api/build/build_approve.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Build Approve" 4 | url = "api-build-approve" 5 | 6 | [menu.api] 7 | weight = 7 8 | identifier = "api-build-approve" 9 | parent = "api_build" 10 | +++ 11 | 12 | Approves a blocked build. 13 | Please note this api requires write access to the repository, 14 | and the request parameter `{build}` is not the build id but the build number. 15 | 16 | ```text 17 | POST /api/repos/{owner}/{repo}/builds/{build}/approve 18 | ``` 19 | -------------------------------------------------------------------------------- /content/api/build/build_decline.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Build Decline" 4 | url = "api-build-decline" 5 | 6 | [menu.api] 7 | weight = 8 8 | identifier = "api-build-decline" 9 | parent = "api_build" 10 | +++ 11 | 12 | Declines a blocked build. 13 | Please note this api requires write access to the repository, 14 | and the request parameter `{build}` is not the build id but the build number. 15 | 16 | ```text 17 | POST /api/repos/{owner}/{repo}/builds/{build}/decline 18 | ``` 19 | -------------------------------------------------------------------------------- /content/api/secret/secret_delete.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Secret Delete" 4 | url = "api-secret-delete" 5 | 6 | [menu.api] 7 | weight = 3 8 | identifier = "api-secret-delete" 9 | parent = "api_secret" 10 | +++ 11 | 12 | Deletes a repository secret. 13 | Please note this api requires write access to the repository, 14 | and the request parameter `{secret}` is not the secret's id but secret name. 15 | 16 | ```text 17 | DELETE /api/repos/{owner}/{repo}/secrets/{secret} 18 | ``` 19 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry info" 4 | url = "cli-registry-info" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-registry-info" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | This subcommand prints the named registry details. Please note this command requires authentication and administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/registry/data/drone_registry_info.out.txt" >}} 16 | ``` 17 | -------------------------------------------------------------------------------- /content/plugin/pipeline/plugin_guidelines.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2016-01-01T00:00:00+00:00 3 | title: "Plugin Guidelines" 4 | url: plugin-guidelines 5 | weight: 2 6 | 7 | menu: 8 | plugin: 9 | parent: pipeline 10 | identifier: plugin-guidelines 11 | --- 12 | 13 | Take a look and fork this [example plugin starter project](https://github.com/drone/drone-plugin-starter) to create a plugin in Go. 14 | 15 | [Submit or update the documentation for a plugin](https://github.com/drone/drone-plugin-index) to the plugin marketplace. 16 | -------------------------------------------------------------------------------- /content/cli/user/drone_user_rm.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone user rm" 4 | url = "cli-user-rm" 5 | 6 | [menu.cli] 7 | weight = 4 8 | identifier = "cli-user-rm" 9 | parent = "cli_user" 10 | +++ 11 | 12 | This subcommand deletes a registered user from the system. Please note this command requires administrative privileges. 13 | 14 | ```text 15 | {{< cat "content/cli/user/data/drone_user_rm.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone user rm octocat 22 | ``` 23 | -------------------------------------------------------------------------------- /content/api/repo/repo_repair.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Repo Repair" 4 | url = "api-repo-repair" 5 | 6 | [menu.api] 7 | weight = 5 8 | identifier = "api-repo-repair" 9 | parent = "api_repo" 10 | +++ 11 | 12 | Recreates webhooks for your repository in your version control system (e.g GitHub). 13 | This can be used if you accidentally delete your webhooks. 14 | Please note this api requires administrative access to the repository. 15 | 16 | ```text 17 | POST /api/repos/{owner}/{repo}/repair 18 | ``` 19 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_ls.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry ls" 4 | url = "cli-registry-ls" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-registry-ls" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | This subcommand returns a list of registry credentials for the named repository. Please note this command requires authentication and administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/registry/data/drone_registry_ls.out.txt" >}} 16 | ``` 17 | -------------------------------------------------------------------------------- /content/cli/user/drone_user_add.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone user add" 4 | url = "cli-user-add" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-user-add" 9 | parent = "cli_user" 10 | +++ 11 | 12 | This subcommand registers a new user with the system. Please note this command requires administrative privileges. 13 | 14 | ```text 15 | {{< cat "content/cli/user/data/drone_user_add.out.txt" >}} 16 | ``` 17 | 18 | Example usage, adds a user by username: 19 | 20 | ```text 21 | $ drone user add octocat 22 | ``` 23 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_add.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo add" 4 | url = "cli-repository-add" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-repository-add" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | This subcommand registers a named repository with Drone. Please note this command requires administrative access to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/repo/data/drone_repo_add.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone repo add octocat/hello-world 22 | ``` 23 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_rm.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo rm" 4 | url = "cli-repository-remove" 5 | 6 | [menu.cli] 7 | weight = 6 8 | identifier = "cli-repository-remove" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | This subcommand deletes the named repository from the system. Please note this command requires administrative access to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/repo/data/drone_repo_rm.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone repo rm octocat/hello-world 22 | ``` 23 | -------------------------------------------------------------------------------- /content/usage/reporting/ccmenu.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:01" 3 | title = "CCMenu" 4 | url = "zh/ccmenu" 5 | 6 | [menu.usage] 7 | weight = 4 8 | identifier = "ccmenu-zh" 9 | parent = "usage_reports" 10 | +++ 11 | 12 | 13 | 14 | Drone 使用支持 [ccmenu](http://ccmenu.org/) 在 Windows 或者 Mac 菜单栏上监控显示仓库的状态。 15 | 16 | CC 路径（endpoint）: 17 | 18 | ```text 19 | :///api/badges///cc.xml 20 | ``` 21 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_info.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry info" 4 | url = "zh/cli-registry-info" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-registry-info-zh" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令打印 registry 的详细信息，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/registry/data/drone_registry_info.out.txt" >}} 18 | ``` 19 | -------------------------------------------------------------------------------- /content/cli/user/drone_user_rm.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone user rm" 4 | url = "zh/cli-user-rm" 5 | 6 | [menu.cli] 7 | weight = 4 8 | identifier = "cli-user-rm-zh" 9 | parent = "cli_user" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来从系统中删除一个注册用户，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/user/data/drone_user_rm.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone user rm octocat 24 | ``` 25 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_rm.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret rm" 4 | url = "cli-secret-rm" 5 | 6 | [menu.cli] 7 | weight = 4 8 | identifier = "cli-secret-rm" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | This subcommand deletes a named repository secret. Please note this command requires administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/secret/data/drone_secret_rm.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | 21 | ```text 22 | $ drone secret rm -repository octocat/hello-world -name docker_password 23 | ``` 24 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_ls.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry ls" 4 | url = "zh/cli-registry-ls" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-registry-ls-zh" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令返回对应仓库的 registry 登录凭据，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/registry/data/drone_registry_ls.out.txt" >}} 18 | ``` 19 | -------------------------------------------------------------------------------- /content/api/user/user_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Current User Info" 4 | url = "api-user-info" 5 | 6 | [menu.api] 7 | weight = 1 8 | identifier = "api-user-info" 9 | parent = "api_user" 10 | +++ 11 | 12 | Returns the currently authenticated user. 13 | 14 | ```text 15 | GET /api/user 16 | ``` 17 | 18 | Example Response Body: 19 | 20 | ```json 21 | { 22 | "id": 1, 23 | "login": "octocat", 24 | "email": "octocat@github.com", 25 | "avatar_url": "http://www.gravatar.com/avatar/7194e8d48fa1d2b689f99443b767316c", 26 | "admin": false, 27 | "active": true 28 | } 29 | ``` 30 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_repair.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo repair" 4 | url = "cli-repository-repair" 5 | 6 | [menu.cli] 7 | weight = 5 8 | identifier = "cli-repository-repair" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | This subcommand re-creates webhooks for your repository in your version control system (e.g GitHub). This can be used if you accidentally delete your webhooks. 13 | 14 | ```text 15 | {{< cat "content/cli/repo/data/drone_repo_repair.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone repo repair octocat/hello-world 22 | ``` 23 | -------------------------------------------------------------------------------- /content/cli/build/data/drone_build_ls.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone build ls - show build history 3 | 4 | USAGE: 5 | drone build ls [command options] 6 | 7 | OPTIONS: 8 | --format value format output (default: "\x1b[33mBuild #{{ .Number }} \x1b[0m\nStatus: {{ .Status }}\nEvent: {{ .Event }}\nCommit: {{ .Commit }}\nBranch: {{ .Branch }}\nRef: {{ .Ref }}\nAuthor: {{ .Author }} {{ if .Email }}<{{.Email}}>{{ end }}\nMessage: {{ .Message }}\n") 9 | --branch value branch filter 10 | --event value event filter 11 | --status value status filter 12 | --limit value limit the list size (default: 25) 13 | 14 | -------------------------------------------------------------------------------- /content/cli/repo/data/drone_repo_update.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone repo update - update a repository 3 | 4 | USAGE: 5 | drone repo update [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --trusted repository is trusted 9 | --gated repository is gated 10 | --timeout value repository timeout (default: 0s) 11 | --visibility value repository visibility 12 | --config value repository configuration path (e.g. .drone.yml) 13 | --build-counter value repository starting build number (default: 0) 14 | --unsafe validate updating the build-counter is unsafe 15 | 16 | -------------------------------------------------------------------------------- /content/plugin/pipeline/plugin_overview.zh.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2016-01-01T00:00:00+00:00 3 | title: "插件概述" 4 | url: zh/plugin-overview 5 | weight: 1 6 | 7 | menu: 8 | plugin: 9 | parent: pipeline 10 | identifier: plugin-overview-zh 11 | --- 12 | 13 | 14 | 15 | 16 | 插件是执行预设任务，并在配置为工作流一部分的 Docker 容器。插件被用来部署代码，发布构建结果，发送通知等任务。 17 | 18 | 19 | 20 | 在工作流中使用 Slack 插件的示例： 21 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_add.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo add" 4 | url = "zh/cli-repository-add" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-repository-add-zh" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来添加一个仓库到 Drone，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/repo/data/drone_repo_add.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone repo add octocat/hello-world 24 | ``` 25 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_rm.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo rm" 4 | url = "zh/cli-repository-remove" 5 | 6 | [menu.cli] 7 | weight = 6 8 | identifier = "cli-repository-remove-zh" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来从 Drone 删除一个仓库，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/repo/data/drone_repo_rm.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone repo rm octocat/hello-world 24 | ``` 25 | -------------------------------------------------------------------------------- /content/cli/user/drone_user_add.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone user add" 4 | url = "zh/cli-user-add" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-user-add-zh" 9 | parent = "cli_user" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来注册一个新用户，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/user/data/drone_user_add.out.txt" >}} 18 | ``` 19 | 20 | 21 | 22 | 添加一个指定用户名的用户： 23 | 24 | ```text 25 | $ drone user add octocat 26 | ``` 27 | -------------------------------------------------------------------------------- /content/api/secret/secret_list.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Secret List" 4 | url = "api-secret-list" 5 | 6 | [menu.api] 7 | weight = 5 8 | identifier = "api-secret-list" 9 | parent = "api_secret" 10 | +++ 11 | 12 | Returns the repository secret list. 13 | Please note this api requires write access to the repository. 14 | 15 | ```text 16 | GET /api/repos/{owner}/{repo}/secrets 17 | ``` 18 | 19 | Example Response Body: 20 | 21 | ```json 22 | [ 23 | { 24 | "id": 1, 25 | "name": "sample_secret_name", 26 | "image": null, 27 | "event": [ 28 | "push", 29 | "tag", 30 | "deployment" 31 | ] 32 | } 33 | ] 34 | ``` 35 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_rm.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret rm" 4 | url = "zh/cli-secret-rm" 5 | 6 | [menu.cli] 7 | weight = 4 8 | identifier = "cli-secret-rm-zh" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来删除仓库的一个的密文，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/secret/data/drone_secret_rm.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | 23 | ```text 24 | $ drone secret rm -repository octocat/hello-world -name docker_password 25 | ``` 26 | -------------------------------------------------------------------------------- /content/api/registry/registry_list.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Registry List" 4 | url = "api-registry-list" 5 | 6 | [menu.api] 7 | weight = 4 8 | identifier = "api-registry-list" 9 | parent = "api_registry" 10 | +++ 11 | 12 | Returns a list of all registries. 13 | Please note this api requires write access to the repository. 14 | 15 | ```text 16 | GET /api/repos/{owner}/{repo}/registry 17 | ``` 18 | 19 | Example Response Body: 20 | 21 | ```json 22 | [ 23 | { 24 | "id": 1, 25 | "address": "docker.io", 26 | "username": "octocat", 27 | "password": "", 28 | "email": "", 29 | "token": "" 30 | } 31 | ] 32 | ``` 33 | -------------------------------------------------------------------------------- /content/api/user/user_info.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "当前用户信息" 4 | url = "zh/api-user-info" 5 | 6 | [menu.api] 7 | weight = 1 8 | identifier = "api-user-info-zh" 9 | parent = "api_user" 10 | +++ 11 | 12 | 13 | 14 | 返回当前登录用户。 15 | 16 | ```text 17 | GET /api/user 18 | ``` 19 | 20 | 21 | 22 | 响应 Body 示例： 23 | 24 | ```json 25 | { 26 | "id": 1, 27 | "login": "octocat", 28 | "email": "octocat@github.com", 29 | "avatar_url": "http://www.gravatar.com/avatar/7194e8d48fa1d2b689f99443b767316c", 30 | "admin": false, 31 | "active": true 32 | } 33 | ``` 34 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_update.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret update" 4 | url = "cli-secret-update" 5 | 6 | [menu.cli] 7 | weight = 5 8 | identifier = "cli-secret-update" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | This subcommand updates a secret in your repository secret store. Please note this command requires administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/secret/data/drone_secret_update.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone secret update \ 22 | -repository octocat/hello-world \ 23 | -name docker_username \ 24 | -value ... 25 | ``` 26 | -------------------------------------------------------------------------------- /content/api/users/users_list.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "User List" 4 | url = "api-users-list" 5 | 6 | [menu.api] 7 | weight = 5 8 | identifier = "api-users-list" 9 | parent = "api_users" 10 | +++ 11 | 12 | Returns a list of all registered users. 13 | Please note this api requires administrative privileges. 14 | 15 | ```text 16 | GET /api/users 17 | ``` 18 | 19 | Example Response Body: 20 | 21 | ```json 22 | [{ 23 | "id": 1, 24 | "login": "octocat", 25 | "email": "octocat@github.com", 26 | "avatar_url": "http://www.gravatar.com/avatar/7194e8d48fa1d2b689f99443b767316c", 27 | "admin": false, 28 | "active": true 29 | } 30 | ] 31 | ``` 32 | -------------------------------------------------------------------------------- /content/api/users/users_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "User Info" 4 | url = "api-users-info" 5 | 6 | [menu.api] 7 | weight = 4 8 | identifier = "api-users-info" 9 | parent = "api_users" 10 | +++ 11 | 12 | Returns information about the named registered user. 13 | Please note this api requires administrative privileges. 14 | 15 | ```text 16 | GET /api/users/{login} 17 | ``` 18 | 19 | Example Response Body: 20 | 21 | ```json 22 | { 23 | "id": 1, 24 | "login": "octocat", 25 | "email": "octocat@github.com", 26 | "avatar_url": "http://www.gravatar.com/avatar/7194e8d48fa1d2b689f99443b767316c", 27 | "admin": false, 28 | "active": true 29 | } 30 | ``` 31 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_repair.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo repair" 4 | url = "zh/cli-repository-repair" 5 | 6 | [menu.cli] 7 | weight = 5 8 | identifier = "cli-repository-repair-zh" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令重建版本控制系统（如 GitHub）的 webhooks，可以在意外地删除了 wenhooks 的情况下使用。 15 | 16 | ```text 17 | {{< cat "content/cli/repo/data/drone_repo_repair.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone repo repair octocat/hello-world 24 | ``` 25 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_chown.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo chown" 4 | url = "cli-repository-chown" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-repository-chown" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | This subcommand lets a user assume ownership of a named repository. Please note this command requires administrative access to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/repo/data/drone_repo_chown.out.txt" >}} 16 | ``` 17 | 18 | Below command assumes ownership to the named repository. Note that the individual executing this command becomes the owner. 19 | 20 | ```text 21 | $ drone repo chown octocat/hello-world 22 | ``` 23 | -------------------------------------------------------------------------------- /content/api/registry/registry_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Registry Info" 4 | url = "api-registry-info" 5 | 6 | [menu.api] 7 | weight = 4 8 | identifier = "api-registry-info" 9 | parent = "api_registry" 10 | +++ 11 | 12 | Returns a registry. 13 | Please note this api requires write access to the repository, 14 | and the request parameter `{registry}` is the registry address. 15 | 16 | ```text 17 | GET /api/repos/{owner}/{repo}/registry/{registry} 18 | ``` 19 | 20 | Example Response Body: 21 | 22 | ```json 23 | { 24 | "id": 1, 25 | "address": "docker.io", 26 | "username": "octocat", 27 | "password": "", 28 | "email": "", 29 | "token": "" 30 | } 31 | ``` 32 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_update.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry update" 4 | url = "cli-registry-update" 5 | 6 | [menu.cli] 7 | weight = 5 8 | identifier = "cli-registry-update" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | This subcommand updates the named registry credentials. Please note this command requires authentication and administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/registry/data/drone_registry_update.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone registry update \ 22 | -repository octocat/hello-world \ 23 | -hostname docker.io \ 24 | -password ... 25 | ``` 26 | -------------------------------------------------------------------------------- /content/api/api_authentication.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:04" 3 | title = "API Authentication" 4 | url = "api-authentication" 5 | 6 | [menu.api] 7 | weight = 2 8 | identifier = "api-authentication" 9 | parent = "api_overview" 10 | +++ 11 | 12 | Drone uses tokens for authentication. You can retrieve your user token from your user profile screen (`/account/token`) in the Drone user interface. 13 | 14 | You can provide your token using the http `Authorization` header: 15 | 16 | ``` 17 | Authorization: Bearer AKIAIOSFODNN7EXAMPLE 18 | ``` 19 | 20 | Or using the `access_token` query parameters: 21 | 22 | ``` 23 | http://drone.mycompany.com/api/user?access_token=AKIAIOSFODNN7EXAMPLE 24 | ``` 25 | -------------------------------------------------------------------------------- /content/cli/misc/data/drone_deploy.out.txt: -------------------------------------------------------------------------------- 1 | NAME: 2 | drone deploy - deploy code 3 | 4 | USAGE: 5 | drone deploy [command options] [arguments...] 6 | 7 | OPTIONS: 8 | --format value format output (default: "Number: {{ .Number }}\nStatus: {{ .Status }}\nCommit: {{ .Commit }}\nBranch: {{ .Branch }}\nRef: {{ .Ref }}\nMessage: {{ .Message }}\nAuthor: {{ .Author }}\nTarget: {{ .Deploy }}\n") 9 | --branch value branch filter (default: "master") 10 | --event value event filter (default: "push") 11 | --status value status filter (default: "success") 12 | --param value, -p value custom parameters to be injected into the job environment. Format: KEY=value 13 | 14 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret info" 4 | url = "cli-secret-info" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-secret-info" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | This subcommand prints the named secret details. Please note this command requires administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/secret/data/drone_secret_info.out.txt" >}} 16 | ``` 17 | 18 | Example command: 19 | 20 | ```text 21 | $ drone secret info \ 22 | -repository octocat/hello-world \ 23 | -name docker_password 24 | 25 | docker_password 26 | Events: push, tag, deployment 27 | Images: plugins/docker 28 | ``` 29 | -------------------------------------------------------------------------------- /content/api/secret/secret_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Secret Info" 4 | url = "api-secret-info" 5 | 6 | [menu.api] 7 | weight = 4 8 | identifier = "api-secret-info" 9 | parent = "api_secret" 10 | +++ 11 | 12 | Returns the repository secret. 13 | Please note this api requires write access to the repository, 14 | and the request parameter `{secret}` is not the secret's id but secret name. 15 | 16 | ```text 17 | GET /api/repos/{owner}/{repo}/secrets/{secret} 18 | ``` 19 | 20 | Example Response Body: 21 | 22 | ```json 23 | { 24 | "id": 1, 25 | "name": "sample_secret_name", 26 | "image": null, 27 | "event": [ 28 | "push", 29 | "tag", 30 | "deployment" 31 | ] 32 | } 33 | ``` 34 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_update.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret update" 4 | url = "zh/cli-secret-update" 5 | 6 | [menu.cli] 7 | weight = 5 8 | identifier = "cli-secret-update-zh" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来更新仓库的一个密文，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/secret/data/drone_secret_update.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone secret update \ 24 | -repository octocat/hello-world \ 25 | -name docker_username \ 26 | -value ... 27 | ``` 28 | -------------------------------------------------------------------------------- /content/cli/misc/drone_exec.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone exec" 4 | url = "cli-exec" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-exec" 9 | parent = "cli_misc" 10 | +++ 11 | 12 | This subcommand executes a local build. 13 | 14 | ```text 15 | {{< cat "content/cli/misc/data/drone_exec.out.txt" >}} 16 | ``` 17 | 18 | If your pipeline uses secrets, these can be injected locally simply by passing environment variables: 19 | 20 | ```text 21 | $ MY_SECRET=mybigsecret drone exec 22 | ``` 23 | 24 | Running a full matrix build is not supported at this time, however you can execute a single matrix axis by passing environment variables to the `drone exec` command: 25 | 26 | ```text 27 | $ GO_VERSION=1.4 drone exec 28 | ``` 29 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_ls.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret ls" 4 | url = "cli-secret-ls" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-secret-ls" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | This subcommand returns a list of secrets for the named repository. Please note this command requires administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/secret/data/drone_secret_ls.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone secret ls --repository octocat/hello-world 22 | 23 | docker_username 24 | Events: push, tag, deployment 25 | Images: plugins/docker 26 | 27 | docker_password 28 | Events: push, tag, deployment 29 | Images: plugins/docker 30 | ``` 31 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_update.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry update" 4 | url = "zh/cli-registry-update" 5 | 6 | [menu.cli] 7 | weight = 5 8 | identifier = "cli-registry-update-zh" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来更新 registry 的登录凭据，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/registry/data/drone_registry_update.out.txt" >}} 18 | ``` 19 | 20 | Example usage: 21 | 22 | ```text 23 | $ drone registry update \ 24 | -repository octocat/hello-world \ 25 | -hostname docker.io \ 26 | -password ... 27 | ``` 28 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_info.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret info" 4 | url = "zh/cli-secret-info" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-secret-info-zh" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来打印密文信息，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | 17 | ```text 18 | {{< cat "content/cli/secret/data/drone_secret_info.out.txt" >}} 19 | ``` 20 | 21 | 使用示例： 22 | 23 | ```text 24 | $ drone secret info \ 25 | -repository octocat/hello-world \ 26 | -name docker_password 27 | 28 | docker_password 29 | Events: push, tag, deployment 30 | Images: plugins/docker 31 | ``` 32 | -------------------------------------------------------------------------------- /.drone.yml: -------------------------------------------------------------------------------- 1 | pipeline: 2 | build: 3 | image: golang 4 | commands: 5 | - mkdir hugo 6 | - curl -sL https://github.com/gohugoio/hugo/releases/download/v0.35/hugo_0.35_Linux-64bit.tar.gz | tar xz -C hugo 7 | - mv hugo/hugo /usr/local/bin 8 | - rm -rf hugo 9 | - ls -la 10 | - hugo version 11 | - hugo 12 | 13 | upload: 14 | image: plugins/s3-sync:1.1 15 | access: public-read 16 | region: us-east-1 17 | bucket: docs.drone.io 18 | source: public/ 19 | target: / 20 | delete: false 21 | content_type: 22 | ".svg": image/svg+xml 23 | "": text/html; charset=utf-8 24 | secrets: 25 | - aws_access_key_id 26 | - aws_secret_access_key 27 | when: 28 | event: push 29 | branch: master 30 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_rm.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry rm" 4 | url = "cli-registry-rm" 5 | 6 | [menu.cli] 7 | weight = 4 8 | identifier = "cli-registry-rm" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | This subcommand deletes a named registry credentials. Please note this command requires authentication and administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/registry/data/drone_registry_rm.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone registry rm -repository octocat/hello-world 22 | ``` 23 | 24 | Example usage with custom docker registry: 25 | 26 | ```text 27 | $ drone registry rm \ 28 | -repository octocat/hello-world \ 29 | -hostname gcr.io 30 | ``` 31 | -------------------------------------------------------------------------------- /content/api/api_overview.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:05" 3 | title = "API Overview" 4 | url = "api-overview" 5 | 6 | [menu.api] 7 | weight = 1 8 | identifier = "api-overview" 9 | parent = "api_overview" 10 | +++ 11 | 12 | Drone provides a comprehensive remote API for interacting with the Drone server. This section of the documents provides instructions for authenticating and using the remote API. 13 | 14 | # Libraries 15 | 16 | Drone provides the following official libraries for integrating with the remote API: 17 | 18 | Language | Repository 19 | -------- | ---------- 20 | Go | https://github.com/drone/drone-go 21 | Node | https://github.com/drone/drone-node 22 | Python | https://github.com/drone/drone-python 23 | Ruby | https://github.com/drone/drone-ruby 24 | -------------------------------------------------------------------------------- /content/install/users/user_admins.es.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Usuarios Administradores" 4 | url = "es/user-admins" 5 | 6 | [menu.install] 7 | weight = 3 8 | identifier = "user-admins-es" 9 | parent = "install_access" 10 | +++ 11 | 12 | Puedes conceder privilegios administrativos a usuarios proveyendo una lista separada por comas de usuarios, usando la variable de ambiente designada. 13 | 14 | ```diff 15 | services: 16 | drone-server: 17 | image: drone/drone:{{% version %}} 18 | environment: 19 | + - DRONE_ADMIN=janedoe,johnsmith 20 | ``` 21 | 22 | Por favor nota que los nombre de usuarios son sensibles entre mayúsculas y minúsculas, y deben coincidir exactamente con los valores retornados con tu sistema de control de versiones (Ej Github). 23 | -------------------------------------------------------------------------------- /content/cli/user/drone_user_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone user info" 4 | url = "cli-user-info" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-user-info" 9 | parent = "cli_user" 10 | +++ 11 | 12 | This subcommand prints information about the named registered user. Please note this command requires administrative privileges. 13 | 14 | ```text 15 | {{< cat "content/cli/user/data/drone_user_info.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone user info octocat 22 | 23 | User: octocat 24 | Email: octocat@github.com 25 | ``` 26 | 27 | Format the output using a custom Go template: 28 | 29 | ```text 30 | $ drone user info --format="{{ .Login }} <{{ .Email }}> octocat" 31 | 32 | octocat 33 | ``` 34 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/header.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | {{ .Hugo.Generator }} 4 | 5 | 6 | 7 | 8 | 10 | 11 | {{ .Title }} 12 | 13 | 14 | 15 | {{ partial "style_reset.html" . }} 16 | {{ partial "style.html" . }} 17 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_chown.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo chown" 4 | url = "zh/cli-repository-chown" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-repository-chown-zh" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来让一个用户获得一个仓库到所有权，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/repo/data/drone_repo_chown.out.txt" >}} 18 | ``` 19 | 20 | 21 | 22 | 下面的命令让运行命令的用户获得对应仓库到所有权。 23 | 24 | ```text 25 | $ drone repo chown octocat/hello-world 26 | ``` 27 | -------------------------------------------------------------------------------- /content/api/secret/secret_create.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Secret Create" 4 | url = "api-secret-create" 5 | 6 | [menu.api] 7 | weight = 1 8 | identifier = "api-secret-create" 9 | parent = "api_secret" 10 | +++ 11 | 12 | Create a new repository secret. 13 | Please note this api requires write access to the repository. 14 | 15 | ```text 16 | POST /api/repos/{owner}/{repo}/secrets 17 | ``` 18 | 19 | Example Request Body: 20 | 21 | ```json 22 | { 23 | "name": "docker_username", 24 | "value": "octocat", 25 | "event": [ 26 | "push", 27 | "tags" 28 | ] 29 | } 30 | ``` 31 | 32 | Example Response Body: 33 | 34 | ```json 35 | { 36 | "id": 1, 37 | "name": "docker_username", 38 | "image": null, 39 | "event": [ 40 | "push", 41 | "tags" 42 | ] 43 | } 44 | ``` 45 | -------------------------------------------------------------------------------- /content/cli/user/drone_user_ls.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone user ls" 4 | url = "cli-user-ls" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-user-ls" 9 | parent = "cli_user" 10 | +++ 11 | 12 | This subcommand prints a list of all registered users. Please note this command requires administrative privileges. 13 | 14 | ```text 15 | {{< cat "content/cli/user/data/drone_user_ls.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone user ls 22 | 23 | jonhsmith 24 | janedoe 25 | octocat 26 | ``` 27 | 28 | Format the output using a custom Go template: 29 | 30 | ```text 31 | $ drone user ls --format="{{ .Login }} <{{ .Email }}>" 32 | 33 | jonhsmith 34 | janedoe 35 | octocat 36 | ``` 37 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_ls.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret ls" 4 | url = "zh/cli-secret-ls" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-secret-ls-zh" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令返回对应仓库仓库密文，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/secret/data/drone_secret_ls.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone repo ls -repository octocat/hello-world 24 | 25 | docker_username 26 | Events: push, tag, deployment 27 | Images: plugins/docker 28 | 29 | docker_password 30 | Events: push, tag, deployment 31 | Images: plugins/docker 32 | ``` 33 | -------------------------------------------------------------------------------- /content/install/users/user_admins.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "用户管理员" 4 | url = "zh/user-admins" 5 | 6 | [menu.install] 7 | weight = 3 8 | identifier = "user-admins-zh" 9 | parent = "install_access" 10 | +++ 11 | 12 | 13 | 14 | 使用环境变量以逗号分隔符来指定拥有管理员权限的用户。 15 | 16 | ```diff 17 | services: 18 | drone-server: 19 | image: drone/drone:{{% version %}} 20 | environment: 21 | + - DRONE_ADMIN=janedoe,johnsmith 22 | ``` 23 | 24 | 25 | 26 | 用户名是大小写敏感的，必须和您使用的版本控制系统（如 GitHub）返回的数值相匹配。 27 | -------------------------------------------------------------------------------- /content/api/users/users_update.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "User Update" 4 | url = "api-users-update" 5 | 6 | [menu.api] 7 | weight = 2 8 | identifier = "api-users-update" 9 | parent = "api_users" 10 | +++ 11 | 12 | Updates the specified user. 13 | Please note this api requires administrative privileges. 14 | 15 | ```text 16 | PATCH /api/users/{login} 17 | ``` 18 | 19 | Example Request Body: 20 | 21 | ```json 22 | { 23 | "email": "octocat@github.com", 24 | "admin": false, 25 | "active": true 26 | } 27 | ``` 28 | 29 | Example Response Body: 30 | 31 | ```json 32 | { 33 | "id": 1, 34 | "login": "octocat", 35 | "email": "octocat@github.com", 36 | "avatar_url": "http://www.gravatar.com/avatar/7194e8d48fa1d2b689f99443b767316c", 37 | "admin": false, 38 | "active": true 39 | } 40 | ``` 41 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo info" 4 | url = "cli-repository-info" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-repository-info" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | This subcommand prints the named repository details. 13 | 14 | ```text 15 | {{< cat "content/cli/repo/data/drone_repo_info.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone repo info octocat/hello-world 22 | 23 | Owner: octocat 24 | Repo: hello-world 25 | Type: git 26 | Private: false 27 | Remote: https://github.com/octocat/hello-world.git 28 | ``` 29 | 30 | Format the output using a custom Go template: 31 | 32 | ```text 33 | $ drone repo info --format="{{ .Link }}" octocat/hello-world 34 | 35 | https://github.com/octocat/hello-world.git 36 | ``` 37 | -------------------------------------------------------------------------------- /content/faq/error-invalid-or-missing-image.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2017-04-15T14:39:04+02:00 3 | title: "Error: Invalid or missing Image" 4 | url: error-invalid-or-missing-image 5 | --- 6 | 7 | This error message occurs when your yaml is malformed and does not properly define an image for a pipeline step or service. 8 | 9 | You must define an image for every pipeline step: 10 | 11 | ```diff 12 | pipeline: 13 | slack: 14 | + image: plugins/slack 15 | room: foo 16 | ``` 17 | 18 | You must define an image for every service: 19 | 20 | ```diff 21 | services: 22 | mysql: 23 | + image: mysql 24 | ``` 25 | 26 | You may not nest steps in your pipeline: 27 | 28 | ```diff 29 | pipeline: 30 | - notify: 31 | - slack: 32 | - image: plugins/slack 33 | - room: foo 34 | + slack: 35 | + image: plugins/slack 36 | + room: foo 37 | ``` 38 | -------------------------------------------------------------------------------- /themes/drone/layouts/partials/menu.html: -------------------------------------------------------------------------------- 1 | {{- $page := .page -}} 2 | {{- $site := .site -}} 3 | 4 |
    5 | {{- range .menu -}} 6 | {{- $menu := .Menu -}} 7 | {{- $is := $page.IsMenuCurrent $menu . -}} 8 | {{- $has := $page.HasMenuCurrent $menu . -}} 9 | {{- if .HasChildren }} 10 |
  • 11 | 12 | {{ default .Name (i18n .Identifier) }} 13 | 14 | 15 | {{- partial "menu.html" (dict "menu" .Children "page" $page "site" $site) -}} 16 |
    • 17 | {{- else -}} 18 |
  • 19 | 20 | {{ default .Name (i18n .Identifier) }} 21 | 22 |
    • 23 | {{- end -}} 24 | {{- end -}} 25 |
26 | -------------------------------------------------------------------------------- /content/faq/error_client_is_newer_than_server.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2017-04-15T14:39:04+02:00 3 | title: "Error: client is newer than server" 4 | url: error-client-is-newer-than-server 5 | --- 6 | 7 | If you are running a legacy version of the Docker daemon you will encounter the following error message: 8 | 9 | ```nohighlight 10 | ERROR: Error response from daemon: client is newer than 11 | server (client API version: 1.26, server API version: 1.24) 12 | ``` 13 | 14 | This can be resolved by configuring your agent with the following environment variable: 15 | 16 | ```nohighlight 17 | DOCKER_API_VERSION=1.24 18 | ``` 19 | 20 | This error message is encountered because Docker has a versioned protocol, and legacy versions of Docker prevent newer versions of the protocol from connecting. The solution is to downgrade the protocol using the DOCKER_API_VERSION environment variable. 21 | -------------------------------------------------------------------------------- /content/cli/user/drone_user_ls.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone user ls" 4 | url = "zh/cli-user-ls" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-user-ls-zh" 9 | parent = "cli_user" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来打印注册用户的列表，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/user/data/drone_user_ls.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone user ls 24 | 25 | jonhsmith 26 | janedoe 27 | octocat 28 | ``` 29 | 30 | Format the output using a custom Go template: 31 | 32 | ```text 33 | $ drone user ls --format="{{ .Login }} <{{ .Email }}>" 34 | 35 | jonhsmith 36 | janedoe 37 | octocat 38 | ``` 39 | -------------------------------------------------------------------------------- /content/cli/user/drone_user_info.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone user info" 4 | url = "zh/cli-user-info" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-user-info-zh" 9 | parent = "cli_user" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来打印一个注册用户的信息，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/user/data/drone_user_info.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone user info octocat 24 | 25 | User: octocat 26 | Email: octocat@github.com 27 | ``` 28 | 29 | 30 | 31 | 使用 Go 模版来格式化输出： 32 | 33 | ```text 34 | $ drone user info --format="{{ .Login }} <{{ .Email }}> octocat" 35 | 36 | octocat 37 | ``` 38 | -------------------------------------------------------------------------------- /content/api/secret/secret_update.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Secret Update" 4 | url = "api-secret-update" 5 | 6 | [menu.api] 7 | weight = 2 8 | identifier = "api-secret-update" 9 | parent = "api_secret" 10 | +++ 11 | 12 | Updates the specified repository secret. 13 | Please note this api requires write access to the repository, 14 | and the request parameter `{secret}` is not the secret's id but secret name. 15 | 16 | ```text 17 | PATCH /api/repos/{owner}/{repo}/secrets/{secret} 18 | ``` 19 | 20 | Example Request Body: 21 | 22 | ```json 23 | { 24 | "value": "octocat", 25 | "event": [ 26 | "push", 27 | "pull_request" 28 | ] 29 | } 30 | ``` 31 | 32 | Example Response Body: 33 | 34 | ```json 35 | { 36 | "id": 1, 37 | "name": "docker_username", 38 | "image": null, 39 | "event": [ 40 | "push", 41 | "pull_request" 42 | ] 43 | } 44 | ``` 45 | -------------------------------------------------------------------------------- /content/api/users/users_create.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "User Create" 4 | url = "api-users-create" 5 | 6 | [menu.api] 7 | weight = 1 8 | identifier = "api-users-create" 9 | parent = "api_users" 10 | +++ 11 | 12 | Creates a user. 13 | Please note this api requires administrative privileges. 14 | 15 | ```text 16 | POST /api/users 17 | ``` 18 | 19 | Example Request Body: 20 | 21 | ```json 22 | { 23 | "login": "octocat", 24 | "email": "octocat@github.com", 25 | "avatar_url": "http://www.gravatar.com/avatar/7194e8d48fa1d2b689f99443b767316c", 26 | "active": true 27 | } 28 | ``` 29 | 30 | Example Response Body: 31 | 32 | ```json 33 | { 34 | "id": 1, 35 | "login": "octocat", 36 | "email": "octocat@github.com", 37 | "avatar_url": "http://www.gravatar.com/avatar/7194e8d48fa1d2b689f99443b767316c", 38 | "admin": false, 39 | "active": true 40 | } 41 | ``` 42 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_info.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo info" 4 | url = "zh/cli-repository-info" 5 | 6 | [menu.cli] 7 | weight = 3 8 | identifier = "cli-repository-info-zh" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令打印一个仓库的详细信息。 15 | 16 | ```text 17 | {{< cat "content/cli/repo/data/drone_repo_info.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone repo info octocat/hello-world 24 | 25 | Owner: octocat 26 | Repo: hello-world 27 | Type: git 28 | Private: false 29 | Remote: https://github.com/octocat/hello-world.git 30 | ``` 31 | 32 | 33 | 34 | 使用 Go 模版来格式化输出： 35 | 36 | ```text 37 | $ drone repo info --format="{{ .Link }}" octocat/hello-world 38 | 39 | https://github.com/octocat/hello-world.git 40 | ``` 41 | -------------------------------------------------------------------------------- /content/faq/drone_is_broken.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2017-04-15T14:39:04+02:00 3 | title: "Drone Is Broken" 4 | url: drone-is-broken 5 | draft: true 6 | --- 7 | 8 | 9 | 10 | # Yaml File 11 | 12 | If your build is failing please provide the full yaml configuration file. It will not be possible to effectively debug issues if we cannot see the commands and configuration being used. 13 | 14 | # Build Logs 15 | 16 | If your build is failing please provide a sample of the logs and include the error message. It will not be possible to effectively debug issues if we cannot see the error message. 17 | 18 | # Drone Logs 19 | 20 | 21 | 22 | ``` 23 | docker logs 24 | docker logs 25 | ``` 26 | 27 | # Drone Version 28 | 29 | Please provide your Drone version number. 30 | 31 | 32 | ``` 33 | $ docker images | grep drone 34 | drone/drone 0.6 de54e7f05ec6 2 months ago 6.61 MB 35 | ``` 36 | -------------------------------------------------------------------------------- /content/usage/config/privileged.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Privileged Mode" 4 | url = "privileged-mode" 5 | 6 | [menu.usage] 7 | weight = 5 8 | identifier = "privileged-mode" 9 | parent = "usage_config" 10 | +++ 11 | 12 | Drone gives the ability to configure privileged mode in the Yaml. You can use this parameter to launch containers with escalated capabilities. 13 | 14 | {{% alert error %}} 15 | Privileged mode is only available to trusted repositories and for security reasons should only be used in private environments. 16 | {{% /alert %}} 17 | 18 | ```diff 19 | pipeline: 20 | build: 21 | image: docker 22 | environment: 23 | - DOCKER_HOST=tcp://docker:2375 24 | commands: 25 | - docker --tls=false ps 26 | 27 | services: 28 | docker: 29 | image: docker:dind 30 | command: [ "--storage-driver=vfs", "--tls=false" ] 31 | + privileged: true 32 | ``` 33 | -------------------------------------------------------------------------------- /content/install/releases/0.6.0-notes/signature.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "0.6.0 Signature Removed" 4 | url = "release-0.6.0-signature" 5 | +++ 6 | 7 | The yaml signature file is now removed. This means you no longer have to sign your yaml every time it changes in order to expose secrets. This does have some security implications for open source projects. Please read below. 8 | 9 | 10 | # Pull Requests 11 | 12 | Secrets are not exposed to pull requests by default. If your repository is public and you choose to override this behavior please note that your secrets are not safe. It is possible for a bad actor to submit a pull request and expose your secrets. 13 | 14 | # Pull Requests + Gating 15 | 16 | Drone has experimental support for gating pull requests and blocking builds from unknown accounts. This is perhaps the best way to mitigate security issues when exposing secrets to pull requests. 17 | -------------------------------------------------------------------------------- /content/plugin/pipeline/plugin_overview.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2016-01-01T00:00:00+00:00 3 | title: "Plugin Overview" 4 | url: plugin-overview 5 | weight: 1 6 | 7 | menu: 8 | plugin: 9 | parent: pipeline 10 | identifier: plugin-overview 11 | --- 12 | 13 | Plugins are Docker containers that perform pre-defined tasks and are configured as steps in your pipeline. Plugins can be used to deploy code, publish artifacts, send notification, and more. 14 | 15 | Example pipeline using the Docker and Slack plugins: 16 | 17 | ```yaml 18 | pipeline: 19 | backend: 20 | image: golang 21 | commands: 22 | - go get 23 | - go build 24 | - go test 25 | 26 | docker: 27 | image: plugins/docker 28 | username: kevinbacon 29 | password: pa55word 30 | repo: foo/bar 31 | tags: latest 32 | 33 | notify: 34 | image: plugins/slack 35 | channel: developers 36 | username: drone 37 | ``` 38 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_rm.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry rm" 4 | url = "zh/cli-registry-rm" 5 | 6 | [menu.cli] 7 | weight = 4 8 | identifier = "cli-registry-rm-zh" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来删除一个 registry 的登录凭据，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/registry/data/drone_registry_rm.out.txt" >}} 18 | ``` 19 | 20 | 21 | 22 | 使用示例： 23 | 24 | ```text 25 | $ drone registry rm -repository octocat/hello-world 26 | ``` 27 | 28 | 29 | 30 | 自定义 Docker registry 示例： 31 | 32 | ```text 33 | $ drone registry rm \ 34 | -repository octocat/hello-world \ 35 | -hostname gcr.io 36 | ``` 37 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_add.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry add" 4 | url = "cli-registry-add" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-registry-add" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | This subcommand adds registry credentials to your repository. Please note this command requires authentication and administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/registry/data/drone_registry_add.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone registry add \ 22 | -repository octocat/hello-world \ 23 | -username octocat \ 24 | -password password 25 | ``` 26 | 27 | Example loads the repository password from file: 28 | 29 | ```text 30 | $ drone registry add \ 31 | -repository octocat/hello-world \ 32 | -hostname gcr.io \ 33 | -username octocat \ 34 | -password @/path/to/token.js 35 | ``` 36 | -------------------------------------------------------------------------------- /content/cli/cli_authentication.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:04" 3 | title = "CLI Authentication" 4 | url = "cli-authentication" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-authentication" 9 | parent = "cli_overview" 10 | +++ 11 | 12 | You will need to provide the Drone command line tools with your server address and personal access token. You can retrieve a Drone personal access token from your user profile screen. Click the show token button. 13 | 14 | ![user token](/images/drone_user_token.png) 15 | 16 | 17 | You can provide the server address and token using environment variables: 18 | 19 | ```nohighlight 20 | export DRONE_SERVER=http://drone.mycompany.com 21 | export DRONE_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... 22 | ``` 23 | 24 | You can confirm the above configuration by running the below command: 25 | 26 | ```nohighlight 27 | $ drone info 28 | User: octocat 29 | Email: octocat@github.com 30 | ``` 31 | -------------------------------------------------------------------------------- /themes/drone/layouts/sitemap/single.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 12 | 13 | 14 |
    15 |
  • 16 | Install 17 | {{ partial "menu.html" (dict "menu" .Site.Menus.install "page" . "site" .Site) }} 18 |
    • 19 |
  • 20 | Usage 21 | {{ partial "menu.html" (dict "menu" .Site.Menus.usage "page" . "site" .Site) }} 22 |
    • 23 |
  • 24 | CLI Reference 25 | {{ partial "menu.html" (dict "menu" .Site.Menus.cli "page" . "site" .Site) }} 26 |
    • 27 | 28 |
  • 29 | API Reference 30 | {{ partial "menu.html" (dict "menu" .Site.Menus.cli "page" . "site" .Site) }} 31 |
    • 32 |
33 | 34 | 35 | -------------------------------------------------------------------------------- /content/install/installation_help.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Installation Help" 4 | url = "installation-help" 5 | 6 | questions_off = true 7 | 8 | [menu.install] 9 | weight = 3 10 | identifier = "installation-help" 11 | parent = "install_overview" 12 | +++ 13 | 14 | If you are experiencing installation issues please be sure to read the documentation and search for existing issues and error messages using the site search. We monitor [stack overflow](http://stackoverflow.com/questions/tagged/drone.io) for questions and answers. 15 | 16 | You can also post questions or comments to our [community forum](https://discourse.drone.io). This is a great place to interact directly with the project maintainers and community members. 17 | 18 | # Reporting Issues 19 | 20 | We unfortunately receive a large number of false positive issues. We ask that you discuss potential problems in our [community forum](https://discourse.drone.io) before creating github issues. 21 | -------------------------------------------------------------------------------- /content/install/releases/0.6.0-notes/networking.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "0.6.0 Networking" 4 | url = "release-0.6.0-networking" 5 | +++ 6 | 7 | Drone now aligns with docker-compose and bridge networking with hostnames. This means services are no longer accessible on `localhost` or `127.0.0.1` and are instead available using their hostname as defined in the yaml configuration file. 8 | 9 | ```diff 10 | pipeline: 11 | build: 12 | image: golang 13 | commands: 14 | - - mysql -h localhost:3306 15 | + - mysql -h mysql:3306 16 | 17 | services: 18 | mysql: 19 | image: mysql 20 | ``` 21 | 22 | There are no immediate plans to continue support for pod networking (e.g. localhost) unless natively supported by Docker. I have opened [this issue](https://github.com/docker/docker/issues/26024) with the Docker project to request native pod networking. Please considering voicing your support if this capability is important to you or your organization. 23 | -------------------------------------------------------------------------------- /themes/drone/layouts/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | {{ partial "header.html" . }} 5 | 6 | 7 | 8 | 20 | 21 |
22 | 23 | {{ partial "languages.html" . }} 24 |
25 | 26 |
27 |

{{.Title}}

28 |
29 |

30 | Welcome to the Drone documentation. 31 |

32 |

33 | You can contribute to the documentation here. 34 |

35 |
36 |
37 | {{ partial "algolia.html" . }} 38 | 39 | 40 | -------------------------------------------------------------------------------- /content/install/extensions/custom_policies.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Custom Policies" 4 | url = "custom-access-policies" 5 | 6 | [menu.install] 7 | parent = "install_enterprise" 8 | identifier = "custom-access-policies" 9 | weight = 12 10 | +++ 11 | 12 | {{% alert enterprise %}} 13 | This feature is only available in the [Enterprise expansion pack](https://drone.io/enterprise/) 14 | {{% /alert %}} 15 | 16 | {{% alert warn %}} 17 | This feature is experimental and should be considered unstable 18 | {{% /alert %}} 19 | 20 | The enterprise expansion pack will include support for advanced access control policies to limit access and usage. 21 | 22 | 23 | # `DRONE_REPO_WHITELIST` 24 | 25 | The repository whitelist is an optional parameter used to limit which repositories can be activated within the system. In order to activate a repository it must match at least one pattern in the whitelist. 26 | 27 | ``` 28 | DRONE_REPO_WHITELIST=Microsoct/*,twitter/* 29 | ``` 30 | -------------------------------------------------------------------------------- /content/usage/getting_help.ru.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "получать помощь" 4 | url = "ru/getting-help" 5 | 6 | questions_off = true 7 | 8 | [menu.usage] 9 | weight = 2 10 | identifier = "getting-help-ru" 11 | parent = "usage_overview" 12 | +++ 13 | 14 | Если у вас возникли проблемы, обязательно прочтите документацию и найдите существующие проблемы и сообщения об ошибках, используя поиск по сайту. Мы отслеживаем [stack overflow](http://stackoverflow.com/questions/tagged/drone.io) для вопросов и ответов. 15 | 16 | Вы также можете публиковать вопросы или комментарии на нашем [форуме сообщества](https://discourse.drone.io). Это отличное место для непосредственного взаимодействия с участниками проекта и членами сообщества. 17 | 18 | # Проблемы с отчетами 19 | 20 | К сожалению, мы получаем большое количество ложноположительных вопросов. Мы просим вас обсудить потенциальные проблемы на нашем [форум сообщества](https://discourse.drone.io) перед созданием проблем github. 21 | -------------------------------------------------------------------------------- /content/install/server/apache.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Setup with Apache" 4 | url = "setup-with-apache" 5 | 6 | [menu.install] 7 | identifier = "setup-with-apache" 8 | parent = "install_server" 9 | weight = 5 10 | +++ 11 | 12 | This guide provides a brief overview for installing Drone server behind the Apache2 webserver. This is an example configuration: 13 | 14 | ```nohighlight 15 | ProxyPreserveHost On 16 | 17 | RequestHeader set X-Forwarded-Proto "https" 18 | 19 | ProxyPass / http://127.0.0.1:8000/ 20 | ProxyPassReverse / http://127.0.0.1:8000/ 21 | ``` 22 | 23 | You must have the below Apache modules installed. 24 | 25 | ```nohighlight 26 | a2enmod proxy 27 | a2enmod proxy_http 28 | ``` 29 | 30 | You must configure Apache to set `X-Forwarded-Proto` when using https. 31 | 32 | ```diff 33 | ProxyPreserveHost On 34 | 35 | +RequestHeader set X-Forwarded-Proto "https" 36 | 37 | ProxyPass / http://127.0.0.1:8000/ 38 | ProxyPassReverse / http://127.0.0.1:8000/ 39 | ``` 40 | -------------------------------------------------------------------------------- /themes/drone/layouts/api/single.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | {{ partial "header.html" . }} 5 | 6 | 7 | 8 | 23 | 24 |
25 | 26 | {{ partial "languages.html" . }} 27 |
28 | 29 |
30 |

{{.Title}}

31 |
32 | {{ .Content }} 33 | 34 | {{ partial "page_meta.html" . }} 35 |
36 | {{ partial "next_prev.html" . }} 37 |
38 | {{ partial "hljs.html" . }} 39 | {{ partial "algolia.html" . }} 40 | 41 | 42 | -------------------------------------------------------------------------------- /themes/drone/layouts/cli/single.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | {{ partial "header.html" . }} 5 | 6 | 7 | 8 | 23 | 24 |
25 | 26 | {{ partial "languages.html" . }} 27 |
28 | 29 |
30 |

{{.Title}}

31 |
32 | {{ .Content }} 33 | 34 | {{ partial "page_meta.html" . }} 35 |
36 | {{ partial "next_prev.html" . }} 37 |
38 | {{ partial "hljs.html" . }} 39 | {{ partial "algolia.html" . }} 40 | 41 | 42 | -------------------------------------------------------------------------------- /content/usage/concepts/cloning.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Cloning 克隆" 4 | url = "zh/cloning" 5 | 6 | [menu.usage] 7 | weight = 3 8 | identifier = "cloning-zh" 9 | parent = "usage_concepts" 10 | +++ 11 | 12 | 13 | 14 | 您可以在工作流中手动配置克隆步骤。如果没有定义具体的克隆步骤，Drone 会自动配置。 15 | 16 | ```diff 17 | +clone: 18 | + git: 19 | + image: plugins/git 20 | 21 | pipeline: 22 | build: 23 | image: golang 24 | commands: 25 | - go build 26 | - go test 27 | ``` 28 | 29 | 30 | 31 | 修改克隆深度的配置示例 32 | 33 | ```diff 34 | clone: 35 | git: 36 | image: plugins/git 37 | + depth: 50 38 | ``` 39 | 40 | 41 | 42 | 使用自定义克隆插件的配置示例 43 | 44 | ```diff 45 | clone: 46 | git: 47 | + image: octocat/custom-git-plugin 48 | ``` 49 | -------------------------------------------------------------------------------- /content/usage/reporting/badges.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:00" 3 | title = "Badges" 4 | url = "badges" 5 | 6 | [menu.usage] 7 | weight = 5 8 | identifier = "badges" 9 | parent = "usage_reports" 10 | +++ 11 | 12 | Drone has integrated support for repository status badges. These badges can be added to your website or project readme file to display the status of your code. 13 | 14 | Badge endpoint: 15 | 16 | ```text 17 | :///api/badges///status.svg 18 | ``` 19 | 20 | The status badge displays the status for the latest build to your default branch (e.g. master). You can customize the branch by adding the `branch` query parameter. 21 | 22 | ```diff 23 | -:///api/badges///status.svg 24 | +:///api/badges///status.svg?branch= 25 | ``` 26 | 27 | Please note status badges do not include pull request results, since the status of a pull request does not provide an accurate representation of your repository state. 28 | -------------------------------------------------------------------------------- /themes/drone/layouts/install/single.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | {{ partial "header.html" . }} 5 | 6 | 7 | 8 | 23 | 24 |
25 | 26 | {{ partial "languages.html" . }} 27 |
28 | 29 |
30 |

{{.Title}}

31 |
32 | {{ .Content }} 33 | 34 | {{ partial "page_meta.html" . }} 35 |
36 | {{ partial "next_prev.html" . }} 37 |
38 | {{ partial "hljs.html" . }} 39 | {{ partial "algolia.html" . }} 40 | 41 | 42 | -------------------------------------------------------------------------------- /themes/drone/layouts/plugin/single.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | {{ partial "header.html" . }} 5 | 6 | 7 | 8 | 23 | 24 |
25 | 26 | {{ partial "languages.html" . }} 27 |
28 | 29 |
30 |

{{.Title}}

31 |
32 | {{ .Content }} 33 | 34 | {{ partial "page_meta.html" . }} 35 |
36 | {{ partial "next_prev.html" . }} 37 |
38 | {{ partial "hljs.html" . }} 39 | {{ partial "algolia.html" . }} 40 | 41 | 42 | -------------------------------------------------------------------------------- /content/install/server/apache.es.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Configuración con Apache" 4 | url = "es/setup-with-apache" 5 | 6 | [menu.install] 7 | identifier = "setup-with-apache-es" 8 | parent = "install_server" 9 | weight = 5 10 | +++ 11 | 12 | Ésta guía provee una vista corta para instalar un servidor de Drone detrás de un servidor Apache2. Ésta es una configuración de ejemplo: 13 | 14 | ```nohighlight 15 | ProxyPreserveHost On 16 | 17 | RequestHeader set X-Forwarded-Proto "https" 18 | 19 | ProxyPass / http://127.0.0.1:8000/ 20 | ProxyPassReverse / http://127.0.0.1:8000/ 21 | ``` 22 | 23 | Debes tener los siguientes módulos de Apache instalados: 24 | 25 | ```nohighlight 26 | a2enmod proxy 27 | a2enmod proxy_http 28 | ``` 29 | 30 | Debes configurar Apache con `X-Forwarded-Proto` cuando se use https. 31 | 32 | ```diff 33 | ProxyPreserveHost On 34 | 35 | +RequestHeader set X-Forwarded-Proto "https" 36 | 37 | ProxyPass / http://127.0.0.1:8000/ 38 | ProxyPassReverse / http://127.0.0.1:8000/ 39 | ``` 40 | -------------------------------------------------------------------------------- /content/install/releases/0.6.0-notes/cloning.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "0.6.0 Cloning Changes" 4 | url = "release-0.6.0-cloning" 5 | +++ 6 | 7 | # Overview 8 | 9 | The clone section is removed from the pipeline and has its own section in the yaml. Please note this change is experimental and the naming could be adjusted in the future. 10 | 11 | ```diff 12 | +clone: 13 | + git: 14 | + image: plugins/git 15 | + depth: 50 16 | 17 | pipeline: 18 | - clone: 19 | - image: plugins/git 20 | - depth: 50 21 | ``` 22 | 23 | Please note that if you are using a plugin to cache your git repository you will need to adjust your pipeline configuration accordingly 24 | 25 | ```diff 26 | +clone: 27 | + from_cache: 28 | + image: drillster/drone-volume-cache 29 | + restore: true 30 | + git: 31 | + image: plugins/git 32 | + depth: 50 33 | 34 | pipeline: 35 | - restore-cache: 36 | - image: drillster/drone-volume-cache 37 | - restore: true 38 | 39 | - clone: 40 | - image: plugins/git 41 | - depth: 50 42 | ``` 43 | -------------------------------------------------------------------------------- /content/usage/getting_help.es.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Obteniendo ayuda" 4 | url = "es/getting-help" 5 | 6 | questions_off = true 7 | 8 | [menu.usage] 9 | weight = 2 10 | identifier = "getting-help-es" 11 | parent = "usage_overview" 12 | +++ 13 | 14 | Si estás teniendo problemas, por favor asegúrate de leer la documentación y buscar problemas existentes y mensajes relacionados usando la búsqueda en el sitio. Nosotros monitoreamos [stack overflow](http://stackoverflow.com/questions/tagged/drone.io) para preguntas y respuestas. 15 | 16 | 19 | 20 | # Reportar problemáticas 21 | 22 | Desafortunadamente recibimos un gran número de problemáticas falsas positivas. Te pedimos que discutas los potenciales problemas en nuestro [canal de discourse](https://discourse.drone.io) antes de crear las incidencias en github. 23 | -------------------------------------------------------------------------------- /content/usage/config/privileged.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Privileged Mode 特权模式" 4 | url = "zh/privileged-mode" 5 | 6 | [menu.usage] 7 | weight = 5 8 | identifier = "privileged-mode-zh" 9 | parent = "usage_config" 10 | +++ 11 | 12 | 13 | 14 | 可以通过配置 Yaml 文件来使用特权模式。可以使用 `privileged` 参数来启动具有提权能力的容器。 15 | 16 | 17 | 18 | {{% alert error %}} 19 | 特权模式只能在可信的仓库中使用。为了保证系统安全，请只在私有环境中使用特权模式。 20 | {{% /alert %}} 21 | 22 | ```diff 23 | pipeline: 24 | build: 25 | image: docker 26 | environment: 27 | - DOCKER_HOST=tcp://docker:2375 28 | commands: 29 | - docker --tls=false ps 30 | 31 | services: 32 | docker: 33 | image: docker:dind 34 | command: [ "--storage-driver=vfs", "--tls=false" ] 35 | + privileged: true 36 | ``` 37 | -------------------------------------------------------------------------------- /content/cli/registry/drone_registry_add.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone registry add" 4 | url = "zh/cli-registry-add" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-registry-add-zh" 9 | parent = "cli_registry" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来添加 registry 的登录凭据，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/registry/data/drone_registry_add.out.txt" >}} 18 | ``` 19 | 20 | 21 | 22 | 使用示例： 23 | 24 | ```text 25 | $ drone registry add \ 26 | -repository octocat/hello-world \ 27 | -username octocat \ 28 | -password password 29 | ``` 30 | 31 | 32 | 33 | 从文件读取仓库密码的示例： 34 | 35 | ```text 36 | $ drone registry add \ 37 | -repository octocat/hello-world \ 38 | -hostname gcr.io \ 39 | -username octocat \ 40 | -password @/path/to/token.js 41 | ``` 42 | -------------------------------------------------------------------------------- /content/install/installation_help.es.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Ayuda de instalación" 4 | url = "es/installation-help" 5 | 6 | questions_off = true 7 | 8 | [menu.install] 9 | weight = 3 10 | identifier = "installation-help-es" 11 | parent = "install_overview" 12 | +++ 13 | 14 | Si estás experimentando problemas con la instalación, por favor asegúrate de leer la documentación y de buscar por reportes similares usando la búsqueda del sitio. Nosotros monitoreamos [stack overflow](http://stackoverflow.com/questions/tagged/drone.io) para preguntas y respuestas. 15 | 16 | 19 | 20 | # Reporte de problemáticas. 21 | 22 | Desafortuadamente recibimos muchas problemáticas falsas positivas. Te pedimos que discutas problemas potenciales en nuestro [canal de discourse](https://discourse.drone.io) antes de crear una incidencia en github. 23 | -------------------------------------------------------------------------------- /themes/drone/static/logo.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /content/usage/config/images.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Images 镜像" 4 | url = "zh/images" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "images-zh" 9 | parent = "usage_config" 10 | +++ 11 | 12 | 13 | 14 | 在 Drone 中，构建环境、插件以及服务容器都是 Docker 镜像。在 Yaml 中使用 image 来指定使用的镜像。 15 | 16 | ```diff 17 | pipeline: 18 | build: 19 | + image: golang:1.6 20 | commands: 21 | - go build 22 | - go test 23 | 24 | publish: 25 | + image: plugins/docker 26 | repo: foo/bar 27 | 28 | services: 29 | database: 30 | + image: mysql 31 | ``` 32 | 33 | 34 | 35 | Drone 支持来自任何 Docker registry 的任何有效的 Docker 镜像。 36 | 37 | ```text 38 | image: golang 39 | image: golang:1.7 40 | image: library/golang:1.7 41 | image: index.docker.io/library/golang 42 | image: index.docker.io/library/golang:1.7 43 | ``` 44 | -------------------------------------------------------------------------------- /content/install/server/nginx.es.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Configuración con Nginx" 4 | url = "es/setup-with-nginx" 5 | 6 | [menu.install] 7 | identifier = "setup-with-nginx-es" 8 | parent = "install_server" 9 | weight = 3 10 | +++ 11 | 12 | Esta guía provee un vistazo básico para instalar un servidor de Drone detrás de un servidor web Nginx. Para obtener opciones de configuración más avanzadas por favor consulta la [documentación oficial](https://www.nginx.com/resources/admin-guide/) de Nginx. 13 | 14 | Configuración de ejemplo: 15 | 16 | ```nginx 17 | server { 18 | listen 80; 19 | server_name drone.example.com; 20 | 21 | location / { 22 | proxy_set_header X-Forwarded-For $remote_addr; 23 | proxy_set_header X-Forwarded-Proto $scheme; 24 | proxy_set_header Host $http_host; 25 | 26 | proxy_pass http://127.0.0.1:8000; 27 | proxy_redirect off; 28 | proxy_http_version 1.1; 29 | proxy_buffering off; 30 | 31 | chunked_transfer_encoding off; 32 | } 33 | } 34 | ``` 35 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_ls.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo ls" 4 | url = "cli-repository-list" 5 | 6 | [menu.cli] 7 | weight = 4 8 | identifier = "cli-repository-list" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | This subcommand returns a full list of user repositories. 13 | 14 | ```text 15 | {{< cat "content/cli/repo/data/drone_repo_ls.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone repo ls 22 | 23 | octocat/hello-world 24 | octocat/fork-spoon 25 | github/gitignore 26 | github/hubot 27 | github/hub 28 | ``` 29 | 30 | Filter the output by organization: 31 | 32 | ```text 33 | $ drone repo ls --org=github 34 | 35 | github/gitignore 36 | github/hubot 37 | github/hub 38 | ``` 39 | 40 | Format the output using a custom Go template: 41 | 42 | ```text 43 | $ drone repo ls --format="{{ .Link }}" 44 | 45 | https://github.com/octocat/hello-world 46 | https://github.com/octocat/fork-spoon 47 | https://github.com/github/gitignore 48 | https://github.com/github/hubot 49 | https://github.com/github/hub 50 | ``` 51 | -------------------------------------------------------------------------------- /content/usage/secrets/secrets_global.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Global Secrets 3 | url: global-secrets 4 | 5 | menu: 6 | usage: 7 | weight: 4 8 | identifier: global-secrets 9 | parent: usage_secrets 10 | --- 11 | 12 | {{% alert enterprise %}} 13 | This feature is only available in the [Enterprise expansion pack](https://drone.io/enterprise/) 14 | {{% /alert %}} 15 | 16 | The enterprise expansion pack provides support for global secrets variables, sourced from a yaml file on your server. You should mount the secrets file into your container and specify the path to the file in your configuration. 17 | 18 | # Configuration 19 | 20 | Please see [the installation notes]({{}}) to configure global secrets file and its restrictions. 21 | 22 | # Precedence 23 | 24 | {{% alert info %}} 25 | Secrets configured via *global secrets* take precedence over secrets configured in individual repositories. 26 | {{% /alert %}} 27 | 28 | # Usage 29 | 30 | Usage notes about [secrets]({{}}) apply for global secrets as well. 31 | -------------------------------------------------------------------------------- /content/usage/examples/redis.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Example using Redis 3 | url: redis-example 4 | 5 | menu: 6 | usage: 7 | weight: 3 8 | identifier: redis_example 9 | parent: usage_examples 10 | --- 11 | 12 | Example Yaml configuration for a project with a Redis service dependency. Note that the redis service will be available at `redis:6379`. 13 | 14 | ```yaml 15 | pipeline: 16 | build: 17 | image: redis 18 | commands: 19 | - redis-cli -h redis ping 20 | - redis-cli -h redis set FOO bar 21 | - redis-cli -h redis get FOO 22 | 23 | services: 24 | redis: 25 | image: redis 26 | ``` 27 | 28 | If you are unable to connect to the redis container please make sure you are giving redis adequate time to initialize and begin accepting connections. 29 | 30 | ```diff 31 | pipeline: 32 | build: 33 | image: redis:3.0 34 | commands: 35 | + - sleep 5 36 | - redis-cli -h redis ping 37 | - redis-cli -h redis set HELLO hello 38 | - redis-cli -h redis get HELLO 39 | 40 | services: 41 | redis: 42 | image: redis:3.0 43 | ``` 44 | -------------------------------------------------------------------------------- /themes/drone/layouts/_default/single.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | {{ partial "header.html" . }} 5 | 6 | 7 | 8 | 23 | 24 |
25 | 26 | {{ partial "languages.html" . }} 27 |
28 | 29 |
30 |

{{.Title}}

31 |
32 | {{ .Content }} 33 | 34 | {{ partial "next_steps.html" . }} 35 | {{ partial "questions.html" . }} 36 | {{ partial "page_meta.html" . }} 37 |
38 | {{ partial "next_prev.html" . }} 39 |
40 | {{ partial "hljs.html" . }} 41 | {{ partial "algolia.html" . }} 42 | 43 | 44 | -------------------------------------------------------------------------------- /content/cli/cli_authentication.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:04" 3 | title = "命令行 认证" 4 | url = "zh/cli-authentication" 5 | 6 | [menu.cli] 7 | weight = 2 8 | identifier = "cli-authentication-zh" 9 | parent = "cli_overview" 10 | +++ 11 | 12 | 13 | 14 | 先设置 Drone 命令行工具的服务器地址和个人访问令牌（personal access token）。个人访问令牌可以从用户资料页面获得。点击 `show token` 按钮。 15 | 16 | ![user token](/images/drone_user_token.png) 17 | 18 | 19 | 20 | 21 | 使用环境变量来提供服务器地址和令牌（token）。 22 | 23 | ```nohighlight 24 | export DRONE_SERVER=http://drone.mycompany.com 25 | export DRONE_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... 26 | ``` 27 | 28 | 29 | 30 | 使用下面的命令来确认上面的设置： 31 | 32 | ```nohighlight 33 | $ drone info 34 | User: octocat 35 | Email: octocat@github.com 36 | ``` 37 | -------------------------------------------------------------------------------- /content/api/repo/repo_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Repo Info" 4 | url = "api-repo-info" 5 | 6 | [menu.api] 7 | weight = 6 8 | identifier = "api-repo-info" 9 | parent = "api_repo" 10 | +++ 11 | 12 | Retrieves the details of a repository. 13 | Please note this api requires read access to the repository. 14 | 15 | ```text 16 | GET /api/repos/{owner}/{repo} 17 | ``` 18 | 19 | Example Response Body: 20 | 21 | ```json 22 | { 23 | "id": 1, 24 | "scm": "git", 25 | "owner": "octocat", 26 | "name": "hello-world", 27 | "full_name": "octocat/hello-world", 28 | "avatar_url": "https://avatars.githubusercontent.com/u/2181346?v=3", 29 | "link_url": "https://github.com/octocat/hello-world", 30 | "clone_url": "https://github.com/octocat/hello-world.git", 31 | "default_branch": "master", 32 | "timeout": 60, 33 | "private": false, 34 | "trusted": false, 35 | "allow_pr": true, 36 | "allow_push": true, 37 | "allow_deploys": false, 38 | "allow_tags": false, 39 | "visibility": "public", 40 | "gated": false, 41 | "active": true, 42 | "last_build": 0, 43 | "config_file": ".drone.yml" 44 | } 45 | ``` 46 | -------------------------------------------------------------------------------- /content/api/repo/repo_list.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Repo List" 4 | url = "api-repo-list" 5 | 6 | [menu.api] 7 | weight = 7 8 | identifier = "api-repo-list" 9 | parent = "api_repo" 10 | +++ 11 | 12 | Returns repositories which are registered to Drone. 13 | 14 | ```text 15 | GET /api/user/repos 16 | ``` 17 | 18 | Example Response Body: 19 | 20 | ```json 21 | [ 22 | { 23 | "id": 1, 24 | "scm": "git", 25 | "owner": "octocat", 26 | "name": "hello-world", 27 | "full_name": "octocat/hello-world", 28 | "avatar_url": "https://avatars.githubusercontent.com/u/2181346?v=3", 29 | "link_url": "https://github.com/octocat/hello-world", 30 | "clone_url": "https://github.com/octocat/hello-world.git", 31 | "default_branch": "master", 32 | "timeout": 60, 33 | "private": false, 34 | "trusted": false, 35 | "allow_pr": true, 36 | "allow_push": true, 37 | "allow_deploys": false, 38 | "allow_tags": false, 39 | "visibility": "public", 40 | "gated": false, 41 | "active": true, 42 | "last_build": 0, 43 | "config_file": ".drone.yml" 44 | } 45 | ] 46 | ``` 47 | -------------------------------------------------------------------------------- /content/install/server/apache.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Apache 配置" 4 | url = "zh/setup-with-apache" 5 | 6 | [menu.install] 7 | identifier = "setup-with-apache-zh" 8 | parent = "install_server" 9 | weight = 5 10 | +++ 11 | 12 | 13 | 14 | 这个指南概述了将 Drone 安装在 Apache2 服务器上。下面是一个示例配置： 15 | 16 | ```nohighlight 17 | ProxyPreserveHost On 18 | 19 | RequestHeader set X-Forwarded-Proto "https" 20 | 21 | ProxyPass / http://127.0.0.1:8000/ 22 | ProxyPassReverse / http://127.0.0.1:8000/ 23 | ``` 24 | 25 | 26 | 27 | 您需要安装下面的 Apache 模块： 28 | 29 | ```nohighlight 30 | a2enmod proxy 31 | a2enmod proxy_http 32 | ``` 33 | 34 | 35 | 36 | 如果需要使用 https，您需要设置 `X-Forwarded-Proto` 37 | 38 | ```diff 39 | ProxyPreserveHost On 40 | 41 | +RequestHeader set X-Forwarded-Proto "https" 42 | 43 | ProxyPass / http://127.0.0.1:8000/ 44 | ProxyPassReverse / http://127.0.0.1:8000/ 45 | ``` 46 | -------------------------------------------------------------------------------- /content/usage/config/images.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Images" 4 | url = "images" 5 | 6 | [menu.usage] 7 | weight = 1 8 | identifier = "images" 9 | parent = "usage_config" 10 | +++ 11 | 12 | Drone uses Docker images for the build environment, for plugins and for service containers. The image field is exposed in the container blocks in the Yaml: 13 | 14 | ```diff 15 | pipeline: 16 | build: 17 | + image: golang:1.6 18 | commands: 19 | - go build 20 | - go test 21 | 22 | publish: 23 | + image: plugins/docker 24 | repo: foo/bar 25 | 26 | services: 27 | database: 28 | + image: mysql 29 | ``` 30 | 31 | Drone supports any valid Docker image from any Docker registry: 32 | 33 | ```text 34 | image: golang 35 | image: golang:1.7 36 | image: library/golang:1.7 37 | image: index.docker.io/library/golang 38 | image: index.docker.io/library/golang:1.7 39 | ``` 40 | 41 | Drone does not automatically upgrade docker images. Example configuration to always pull the latest image when updates are available: 42 | 43 | ```diff 44 | pipeline: 45 | build: 46 | image: golang:latest 47 | + pull: true 48 | ``` 49 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_ls.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo ls" 4 | url = "zh/cli-repository-list" 5 | 6 | [menu.cli] 7 | weight = 4 8 | identifier = "cli-repository-list-zh" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令返回用户仓库列表。 15 | 16 | ```text 17 | {{< cat "content/cli/repo/data/drone_repo_ls.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone repo ls 24 | 25 | octocat/hello-world 26 | octocat/fork-spoon 27 | github/gitignore 28 | github/hubot 29 | github/hub 30 | ``` 31 | 32 | 33 | 34 | 按照组织来筛选： 35 | 36 | ```text 37 | $ drone repo ls --org=github 38 | 39 | github/gitignore 40 | github/hubot 41 | github/hub 42 | ``` 43 | 44 | 45 | 46 | 使用 Go 模版来格式化输出： 47 | 48 | ```text 49 | $ drone repo ls --format="{{ .Link }}" 50 | 51 | https://github.com/octocat/hello-world 52 | https://github.com/octocat/fork-spoon 53 | https://github.com/github/gitignore 54 | https://github.com/github/hubot 55 | https://github.com/github/hub 56 | ``` 57 | -------------------------------------------------------------------------------- /content/api/repo/repo_create.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Repo Create" 4 | url = "api-repo-create" 5 | 6 | [menu.api] 7 | weight = 1 8 | identifier = "api-repo-create" 9 | parent = "api_repo" 10 | +++ 11 | 12 | Registers a named repository with Drone. 13 | Please note this api requires administrative access to the repository. 14 | 15 | ```text 16 | POST /api/repos/{owner}/{name} 17 | ``` 18 | 19 | Example Response Body: 20 | 21 | ```json 22 | { 23 | "id": 1, 24 | "scm": "git", 25 | "owner": "octocat", 26 | "name": "hello-world", 27 | "full_name": "octocat/hello-world", 28 | "avatar_url": "https://avatars.githubusercontent.com/u/2181346?v=3", 29 | "link_url": "https://github.com/octocat/hello-world", 30 | "clone_url": "https://github.com/octocat/hello-world.git", 31 | "default_branch": "master", 32 | "timeout": 60, 33 | "private": false, 34 | "trusted": false, 35 | "allow_pr": true, 36 | "allow_push": true, 37 | "allow_deploys": false, 38 | "allow_tags": false, 39 | "visibility": "public", 40 | "gated": false, 41 | "active": true, 42 | "last_build": 0, 43 | "config_file": ".drone.yml" 44 | } 45 | ``` 46 | -------------------------------------------------------------------------------- /content/install/users/user_management.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "User Management" 4 | url = "user-management" 5 | 6 | [menu.install] 7 | weight = 3 8 | identifier = "user-management" 9 | parent = "install_access" 10 | +++ 11 | 12 | You can manually manage user registration using the command line utility. Please see the command line documentation for installing and configuring the command line utility. 13 | 14 | Use the `ls` command to list all active users: 15 | 16 | ```nohighlight 17 | drone user ls 18 | ``` 19 | 20 | Use the `add` command to add users to the system by login: 21 | 22 | ```nohighlight 23 | drone user add octocat 24 | ``` 25 | 26 | Use the `rm` command to remove users from the system by login: 27 | 28 | ```nohighlight 29 | drone user rm octocat 30 | ``` 31 | 32 | Please note that only drone administrators can manage users. Please see the below example to configure one or many administrators, separated by a comma, using the designated environment variable. 33 | 34 | ```diff 35 | services: 36 | drone-server: 37 | image: drone/drone:{{% version %}} 38 | environment: 39 | + - DRONE_ADMIN=janedoe,johnsmith 40 | ``` 41 | -------------------------------------------------------------------------------- /content/install/releases/0.6.0-notes/cloning.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "0.6.0 克隆步骤的变化" 4 | url = "zh/release-0.6.0-cloning" 5 | +++ 6 | 7 | 8 | 9 | # 概述 10 | 11 | 12 | 13 | 克隆步骤从 pipeline 中移除，成为一个独立的章节。这是一个实验性的变更，在以后的版本中可能还有变化。 14 | 15 | ```diff 16 | +clone: 17 | + git: 18 | + image: plugins/git 19 | + depth: 50 20 | 21 | pipeline: 22 | - clone: 23 | - image: plugins/git 24 | - depth: 50 25 | ``` 26 | 27 | 28 | 29 | 如果您使用插件来缓存 git 仓库，您需要调整您的工作流配置。 30 | 31 | ```diff 32 | +clone: 33 | + from_cache: 34 | + image: drillster/drone-volume-cache 35 | + restore: true 36 | + git: 37 | + image: plugins/git 38 | + depth: 50 39 | 40 | pipeline: 41 | - restore-cache: 42 | - image: drillster/drone-volume-cache 43 | - restore: true 44 | 45 | - clone: 46 | - image: plugins/git 47 | - depth: 50 48 | ``` 49 | -------------------------------------------------------------------------------- /content/usage/examples/selenium.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Example using Selenium 3 | url: selenium-example 4 | 5 | menu: 6 | usage: 7 | weight: 6 8 | identifier: selenium_example 9 | parent: usage_examples 10 | --- 11 | 12 | Example Yaml configuration for a project with a Selenium service dependency. Note the selenium service will be available to at `http://selenium:4444/wd/hub` 13 | 14 | ```diff 15 | pipeline: 16 | build: 17 | image: golang 18 | commands: 19 | - go get 20 | - go test 21 | 22 | services: 23 | + selenium: 24 | + image: selenium/standalone-chrome 25 | ``` 26 | 27 | Example Yaml configuration for a project with a Selenium Grid service dependency, using Chrome and Firefox Selenium nodes. 28 | 29 | ```yaml 30 | services: 31 | selenium: 32 | image: selenium/hub 33 | 34 | chrome: 35 | image: selenium/node-chrome 36 | environment: 37 | HUB_PORT_4444_TCP_ADDR: selenium 38 | HUB_PORT_4444_TCP_PORT: 4444 39 | DISPLAY: ":99.0" 40 | 41 | firefox: 42 | image: selenium/node-firefox 43 | environment: 44 | HUB_PORT_4444_TCP_ADDR: selenium 45 | HUB_PORT_4444_TCP_PORT: 4444 46 | DISPLAY: ":98.0" 47 | ``` 48 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_update.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo update" 4 | url = "cli-repository-update" 5 | 6 | [menu.cli] 7 | weight = 7 8 | identifier = "cli-repository-update" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | This subcommand updates a named repository. Please note this command requires write access to the repository. 13 | 14 | 15 | ```text 16 | {{< cat "content/cli/repo/data/drone_repo_update.out.txt" >}} 17 | ``` 18 | 19 | Example command updates the trusted flag: 20 | 21 | ```text 22 | $ drone repo update octocat/hello-world --trusted=true 23 | ``` 24 | 25 | Example command updates the gated flag: 26 | 27 | ```text 28 | $ drone repo update octocat/hello-world --gated=true 29 | ``` 30 | 31 | Example command updates the timeout value: 32 | 33 | ```text 34 | $ drone repo update octocat/hello-world --timeout=90m 35 | ``` 36 | 37 | Example command updates the drone.yml file path 38 | 39 | ```text 40 | $ drone repo update octocat/hello-world --config=.github/.drone.yml 41 | ``` 42 | 43 | Example command updates the current build number 44 | 45 | ```text 46 | $ drone repo update octocat/hello-world --build-counter=10 --unsafe 47 | ``` 48 | -------------------------------------------------------------------------------- /content/usage/getting_help.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "获得帮助" 4 | url = "zh/getting-help" 5 | 6 | questions_off = true 7 | 8 | [menu.usage] 9 | weight = 2 10 | identifier = "getting-help-zh" 11 | parent = "usage_overview" 12 | +++ 13 | 14 | 15 | 16 | 如果您遇到了问题，您可以先阅读对应的文档，使用站内搜索来搜索已有的问题和错误信息。我们同时还关注着 [stack overflow](http://stackoverflow.com/questions/tagged/drone.io) 上的有关问题和回答。 17 | 18 | 21 | 22 | 23 | # 报告问题 24 | 25 | 26 | 27 | 很不幸的是，我们接到了很多假阳性的报告。我们希望您在提交 GitHub issues 前，请先在 [discourse](discourse.drone.io) 上与我们交流。 28 | -------------------------------------------------------------------------------- /content/cli/repo/drone_repo_update.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone repo update" 4 | url = "zh/cli-repository-update" 5 | 6 | [menu.cli] 7 | weight = 7 8 | identifier = "cli-repository-update-zh" 9 | parent = "cli_repo" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令用来更新一个仓库，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | 17 | ```text 18 | {{< cat "content/cli/repo/data/drone_repo_update.out.txt" >}} 19 | ``` 20 | 21 | 22 | 23 | 更新 trusted 标签的示例： 24 | 25 | ```text 26 | $ drone repo update octocat/hello-world --truted=true 27 | ``` 28 | 29 | 30 | 31 | 更新 gated 标签的示例： 32 | 33 | ```text 34 | $ drone repo update octocat/hello-world --gated=true 35 | ``` 36 | 37 | 38 | 39 | 更新超时的示例： 40 | 41 | ```text 42 | $ drone repo update octocat/hello-world --timeout=90m 43 | ``` 44 | 45 | 46 | 47 | 更新 drone.yml 的示例： 48 | 49 | ```text 50 | $ drone repo update octocat/hello-world --config=.github/.drone.yml 51 | ``` 52 | -------------------------------------------------------------------------------- /content/usage/config/volumes.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Volumes" 4 | url = "docker-volumes" 5 | 6 | [menu.usage] 7 | weight = 6 8 | identifier = "volumes" 9 | parent = "usage_config" 10 | +++ 11 | 12 | Drone gives the ability to define Docker volumes in the Yaml. You can use this parameter to mount files or folders on the host machine into your containers. 13 | 14 | {{% alert error %}} 15 | Volumes are only available to trusted repositories and for security reasons should only be used in private environments. 16 | {{% /alert %}} 17 | 18 | ```diff 19 | pipeline: 20 | build: 21 | image: docker 22 | commands: 23 | - docker build --rm -t octocat/hello-world . 24 | - docker run --rm octocat/hello-world --test 25 | - docker push octocat/hello-world 26 | - docker rmi octocat/hello-world 27 | volumes: 28 | + - /var/run/docker.sock:/var/run/docker.sock 29 | ``` 30 | 31 | Please note that Drone mounts volumes on the host machine. This means you must use absolute paths when you configure volumes. Attempting to use relative paths will result in an error. 32 | 33 | ```diff 34 | - volumes: [ ./certs:/etc/ssl/certs ] 35 | + volumes: [ /etc/ssl/certs:/etc/ssl/certs ] 36 | ``` 37 | -------------------------------------------------------------------------------- /content/faq/error_insufficient_privileges.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2017-04-15T14:39:04+02:00 3 | title: "Error: Insufficient privileges" 4 | url: error-insufficient-privileges 5 | --- 6 | 7 | These error messages occur when the Yaml sets restricted configuration parameters, which are disabled by default for security reasons. 8 | 9 | ``` 10 | ERROR: Insufficient privileges to use privileged mode 11 | ERROR: Insufficient privileges to override shm_size 12 | ERROR: Insufficient privileges to use custom dns 13 | ERROR: Insufficient privileges to use dns_search 14 | ERROR: Insufficient privileges to use devices 15 | ERROR: Insufficient privileges to use extra_hosts 16 | ERROR: Insufficient privileges to override the network 17 | ERROR: Insufficient privileges to disable oom_kill 18 | ERROR: Insufficient privileges to use volumes 19 | ERROR: Insufficient privileges to use volumes_from 20 | ``` 21 | 22 | The above errors can be resolved by having an administrator grant your repository elevated privileges, by toggling the trusted flag in the repository settings. 23 | 24 | {{% alert error %}} 25 | Trusted mode should only be enabled in trusted, private environments. This flag could otherwise allow an attacker to compromise your host system. 26 | {{% /alert %}} 27 | -------------------------------------------------------------------------------- /content/api/repo/repo_delete.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Repo Delete" 4 | url = "api-repo-delete" 5 | 6 | [menu.api] 7 | weight = 3 8 | identifier = "api-repo-delete" 9 | parent = "api_repo" 10 | +++ 11 | 12 | Permanently deletes a repository. It cannot be undone. 13 | Please note this api requires administrative access to the repository, 14 | and repository's secrets and builds aren't deleted. 15 | 16 | ```text 17 | DELETE /api/repos/{owner}/{repo} 18 | ``` 19 | 20 | Example Response Body: 21 | 22 | ```json 23 | { 24 | "id": 1, 25 | "scm": "git", 26 | "owner": "octocat", 27 | "name": "hello-world", 28 | "full_name": "octocat/hello-world", 29 | "avatar_url": "https://avatars.githubusercontent.com/u/2181346?v=3", 30 | "link_url": "https://github.com/octocat/hello-world", 31 | "clone_url": "https://github.com/octocat/hello-world.git", 32 | "default_branch": "master", 33 | "timeout": 60, 34 | "private": false, 35 | "trusted": false, 36 | "allow_pr": true, 37 | "allow_push": true, 38 | "allow_deploys": false, 39 | "allow_tags": false, 40 | "visibility": "public", 41 | "gated": false, 42 | "active": false, 43 | "last_build": 0, 44 | "config_file": ".drone.yml" 45 | } 46 | ``` 47 | -------------------------------------------------------------------------------- /themes/drone/static/css/reset.css: -------------------------------------------------------------------------------- 1 | html, body, div, span, applet, object, iframe, 2 | h1, h2, h3, h4, h5, h6, p, blockquote, pre, 3 | a, abbr, acronym, address, big, cite, code, 4 | del, dfn, em, img, ins, kbd, q, s, samp, 5 | small, strike, strong, sub, sup, tt, var, 6 | b, u, i, center, 7 | dl, dt, dd, ol, ul, li, 8 | fieldset, form, label, legend, 9 | table, caption, tbody, tfoot, thead, tr, th, td, 10 | article, aside, canvas, details, embed, 11 | figure, figcaption, footer, header, hgroup, 12 | menu, nav, output, ruby, section, summary, 13 | time, mark, audio, video { 14 | margin: 0; 15 | padding: 0; 16 | border: 0; 17 | font-size: 100%; 18 | font: inherit; 19 | vertical-align: baseline; 20 | font-size: 14px; 21 | font-family: "Noto Sans"; 22 | } 23 | /* HTML5 display-role reset for older browsers */ 24 | article, aside, details, figcaption, figure, 25 | footer, header, hgroup, menu, nav, section { 26 | display: block; 27 | } 28 | body { 29 | line-height: 1; 30 | } 31 | ol, ul, nav { 32 | list-style: none; 33 | } 34 | blockquote, q { 35 | quotes: none; 36 | } 37 | blockquote:before, blockquote:after, 38 | q:before, q:after { 39 | content: ''; 40 | content: none; 41 | } 42 | table { 43 | border-collapse: collapse; 44 | border-spacing: 0; 45 | } 46 | -------------------------------------------------------------------------------- /content/install/releases/0.6.0-notes/signature.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "0.6.0 移除签名" 4 | url = "zh/release-0.6.0-signature" 5 | +++ 6 | 7 | 8 | 9 | yaml 签名已经被移除，这意味着不再需要签名 yaml 文件来使用密文。这对开源项目有一定的安全隐患，请阅读下面的章节来了解更多信息。 10 | 11 | 12 | 13 | # Pull Requests 14 | 15 | 16 | 17 | 默认在 pull request 中不使用密文。如果您的项目是开源项目，您希望修改这一默认行为，请注意这是不安全的。恶意的 pull request 可以暴露密文。 18 | 19 | 20 | 21 | # Pull Requests + Gating 门禁 22 | 23 | 24 | 25 | Drone 实验性支持 门禁 gating pull request 以及拦截来自未知账户的 pull request。这可能是处理密文被暴露等安全问题的最好方式。 26 | -------------------------------------------------------------------------------- /content/install/server/caddy.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Setup with Caddy" 4 | url = "zh/setup-with-caddy" 5 | 6 | [menu.install] 7 | identifier = "setup-with-caddy-zh" 8 | parent = "install_server" 9 | weight = 4 10 | +++ 11 | 12 | 13 | 14 | 这个指南概述了将 Drone 安装在 [Caddy](https://caddyserver.com/) 上。下面是一个示例配置： 15 | 16 | 17 | ```nohighlight 18 | drone.mycomopany.com { 19 | proxy / localhost:8000 { 20 | websocket 21 | transparent 22 | } 23 | } 24 | ``` 25 | 26 | 27 | 28 | 您需要启用 websocket upgrade： 29 | 30 | ```diff 31 | drone.mycomopany.com { 32 | proxy / localhost:8000 { 33 | + websocket 34 | transparent 35 | } 36 | } 37 | ``` 38 | 39 | 40 | 41 | 您需要使用 `transparent` 语法来配置反向代理包含 `X-Forwarded` 头 42 | 43 | ```diff 44 | drone.mycomopany.com { 45 | proxy / localhost:8000 { 46 | websocket 47 | + transparent 48 | } 49 | } 50 | ``` 51 | -------------------------------------------------------------------------------- /content/usage/reporting/badges.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:00" 3 | title = "Badges 标签" 4 | url = "zh/badges" 5 | 6 | [menu.usage] 7 | weight = 5 8 | identifier = "badges-zh" 9 | parent = "usage_reports" 10 | +++ 11 | 12 | 13 | 14 | Drone 支持显示仓库状态 Badge 标签。这些标签可以被添加到网站或者项目的 readme 中来显示代码的状态。 15 | 16 | Badge 路径（endpoint）: 17 | 18 | ```text 19 | :///api/badges///status.svg 20 | ``` 21 | 22 | 23 | 24 | 默认 badge 标签显示了默认分支（比如 master）上的最新构建状态。可以通过添加 `?branch=` 来自定义分支。 25 | 26 | ```diff 27 | -:///api/badges///status.svg 28 | +:///api/badges///status.svg?branch= 29 | ``` 30 | 31 | 32 | 33 | 请注意 badge 标签不包括合并请求（pull request）的构建结果，因为合并请求并不代表仓库的准确状态。 34 | -------------------------------------------------------------------------------- /content/install/installation_help.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "安装帮助" 4 | url = "zh/installation-help" 5 | 6 | questions_off = true 7 | 8 | [menu.install] 9 | weight = 3 10 | identifier = "installation-help-zh" 11 | parent = "install_overview" 12 | +++ 13 | 14 | 15 | 16 | 如果遇到了安装问题，请先阅读对应文档、搜索对应的问题（GitHub issue）和错误信息。我们关注了 [stack overflow](http://stackoverflow.com/questions/tagged/drone.io) 上的问题和回答。 17 | 18 | 21 | 22 | 23 | 24 | # 报告问题 25 | 26 | 27 | 28 | 很不幸的是，我们接到了大量的误报。我们希望您在提交 GitHub issues 前，请先在 [community forum](https://discourse.drone.io/) 上与我们交流。 29 | -------------------------------------------------------------------------------- /content/install/releases/0.6.0-notes/networking.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "0.6.0 网络" 4 | url = "zh/release-0.6.0-networking" 5 | +++ 6 | 7 | 8 | 9 | Drone 现在支持 docker-compose 和 桥接网络的 hostnames，这意味着服务不在从 `localhost` 或者 `127.0.0.1` 来访问，而是从它们的 在 yaml 文件中定义的 hostname 来访问。 10 | 11 | ```diff 12 | pipeline: 13 | build: 14 | image: golang 15 | commands: 16 | - - mysql -h localhost:3306 17 | + - mysql -h mysql:3306 18 | 19 | services: 20 | mysql: 21 | image: mysql 22 | ``` 23 | 24 | 25 | 26 | 目前没有继续支持 pod network 的计划，即 localhost，除非 Docker 支持这一网络。[这个 issue](https://github.com/docker/docker/issues/26024) 是有关 请求 Docker 项目原生支持 pod networking。如果您或您的组织有相应的需求，请反馈到这里。 27 | -------------------------------------------------------------------------------- /content/usage/examples/mongo.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Example using Mongo 3 | url: mongodb-example 4 | 5 | menu: 6 | usage: 7 | weight: 3 8 | identifier: mongodb_example 9 | parent: usage_examples 10 | --- 11 | 12 | Example Yaml configuration for a project with a MongoDB service dependency. Note that the mongo service will be available at `mongo:27017`. 13 | 14 | ```yaml 15 | pipeline: 16 | ping: 17 | image: mongo:3.0 18 | commands: 19 | - sleep 15 20 | - mongo --host mongo --eval "{ ping: 1 }" 21 | 22 | services: 23 | mongo: 24 | image: mongo:3.0 25 | command: [ --smallfiles ] 26 | ``` 27 | 28 | If you are unable to connect to the mongo container please make sure you are giving mongodb adequate time to initialize and begin accepting connections. 29 | 30 | ```diff 31 | pipeline: 32 | ping: 33 | image: mongo:3.0 34 | commands: 35 | + - sleep 15 36 | - mongo --host mongo --eval "{ ping: 1 }" 37 | 38 | services: 39 | mongo: 40 | image: mongo:3.0 41 | command: [ --smallfiles ] 42 | ``` 43 | 44 | If you are still unable to connect to the mongo container, please make sure you are using the service name as the hostname. 45 | 46 | ```diff 47 | - mongo --host localhost --eval "{ ping: 1 }" 48 | + mongo --host mongo --eval "{ ping: 1 }" 49 | ``` 50 | -------------------------------------------------------------------------------- /content/install/users/user_management.es.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Manejo de usuarios" 4 | url = "es/user-management" 5 | 6 | [menu.install] 7 | weight = 2 8 | identifier = "user-management-es" 9 | parent = "install_access" 10 | +++ 11 | 12 | Puedes manejar el registro de usuarios manualmente usando la utilidad de línea de comandos. Por favor mira la documentación de la utilidad de línea de comandos para instalar y configurar la utilidad de línea de comandos. 13 | 14 | Usa el comando `ls` para listar todos los usuarios activos: 15 | 16 | ```nohighlight 17 | drone user ls 18 | ``` 19 | 20 | Usa el comando `add` para agregar usuarios al sistema por nombre de usuario: 21 | 22 | ```nohighlight 23 | drone user add octocat 24 | ``` 25 | 26 | Usa el comando `rm` para eliminar usuarios del sistema por nombre de usuario: 27 | 28 | ```nohighlight 29 | drone user rm octocat 30 | ``` 31 | 32 | Por favor nota que solamente los administradores pueden manejar usuarios. En el ejemplo que mostraremos a continuación configuraremos varios administradores separados por coma, usando la variable de ambiente correspondiente. 33 | 34 | ```diff 35 | services: 36 | drone-server: 37 | image: drone/drone:{{% version %}} 38 | environment: 39 | + - DRONE_ADMIN=janedoe,johnsmith 40 | ``` 41 | -------------------------------------------------------------------------------- /content/usage/secrets/registries_global.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Global Registry Credentials 3 | url: global-registries 4 | 5 | menu: 6 | usage: 7 | weight: 2 8 | identifier: global-registries 9 | parent: usage_secrets 10 | --- 11 | 12 | {{% alert enterprise %}} 13 | This feature is only available in the [Enterprise expansion pack](https://drone.io/enterprise/) 14 | {{% /alert %}} 15 | 16 | The enterprise expansion pack provides support for global registry credentials, sourced from a yaml file on your server. You should mount the credentials file into your container and specify the path to the file in your configuration. 17 | 18 | # Configuration 19 | 20 | Please see [the installation notes]({{}}) to configure global registries file and its restrictions. 21 | 22 | # Precedence 23 | 24 | {{% alert info %}} 25 | Credentials configured via *individual repositories* take precedence over credentials configured in global registries. 26 | {{% /alert %}} 27 | 28 | {{% alert warn %}} 29 | In versions < `0.8.4`, credentials configured via *global registries* take precedence over credentials configured in individual repositories. 30 | {{% /alert %}} 31 | 32 | # Usage 33 | 34 | Usage notes about [registry credentials]({{}}) apply for global registry credentials as well. 35 | -------------------------------------------------------------------------------- /content/usage/concepts/plugins.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Plugins" 4 | url = "using-plugins" 5 | 6 | [menu.usage] 7 | weight = 7 8 | identifier = "plugins" 9 | parent = "usage_concepts" 10 | +++ 11 | 12 | Plugins are Docker containers that perform pre-defined tasks and are configured as steps in your pipeline. Plugins can be used to deploy code, publish artifacts, send notification, and more. 13 | 14 | Example pipeline using the Docker and Slack plugins: 15 | 16 | ```yaml 17 | pipeline: 18 | build: 19 | image: golang 20 | commands: 21 | - go build 22 | - go test 23 | 24 | publish: 25 | image: plugins/docker 26 | repo: foo/bar 27 | tags: latest 28 | 29 | notify: 30 | image: plugins/slack 31 | channel: dev 32 | ``` 33 | 34 | # Plugin Isolation 35 | 36 | Plugins are executed in Docker containers and are isolated from the other steps in your build pipeline. Plugins do share the build workspace, mounted as a volume, and therefore have access to your source tree. 37 | 38 | # Plugin Marketplace 39 | 40 | Plugins are packaged and distributed as Docker containers. They are conceptually similar to software libraries (think npm) and can be published and shared with the community. You can find a list of available plugins at [http://plugins.drone.io](http://plugins.drone.io). 41 | -------------------------------------------------------------------------------- /content/usage/examples/node.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Example using Node 3 | url: node-example 4 | 5 | menu: 6 | usage: 7 | weight: 2 8 | identifier: node_example 9 | parent: usage_examples 10 | --- 11 | 12 | Example Yaml configuration for a project written in JavaScript using Node: 13 | 14 | ```diff 15 | pipeline: 16 | build: 17 | image: node:latest 18 | commands: 19 | - npm install 20 | - npm run test 21 | ``` 22 | 23 | Using the official Node images: 24 | 25 | ```diff 26 | pipeline: 27 | build: 28 | + image: node:latest 29 | commands: 30 | - npm install 31 | - npm run lint 32 | - npm run test 33 | ``` 34 | 35 | Using the official NPM plugin to publish packages: 36 | 37 | ```diff 38 | pipeline: 39 | build: 40 | image: node:latest 41 | commands: 42 | - npm install 43 | - npm run lint 44 | - npm run test 45 | publish: 46 | + image: plugins/npm 47 | + when: 48 | + branch: master 49 | ``` 50 | 51 | Using the build matrix to test multiple node versions: 52 | 53 | ```diff 54 | pipeline: 55 | build: 56 | - image: node:latest 57 | + image: node:${NODE_VERSION} 58 | commands: 59 | - npm install 60 | - npm run lint 61 | - npm run test 62 | 63 | +matrix: 64 | + NODE_VERSION: 65 | + - latest 66 | + - "7" 67 | + - "6" 68 | + - "4" 69 | ``` 70 | -------------------------------------------------------------------------------- /content/usage/getting_help.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Getting Help" 4 | url = "getting-help" 5 | 6 | questions_off = true 7 | 8 | [menu.usage] 9 | weight = 2 10 | identifier = "getting-help" 11 | parent = "usage_overview" 12 | +++ 13 | 14 | If you are experiencing issues please be sure to read the documentation and search for existing issues and error messages using site search. We monitor [stack overflow](http://stackoverflow.com/questions/tagged/drone.io) for questions and answers. 15 | 16 | You can also post questions or comments to our [community forum](https://discourse.drone.io). This is a great place to interact directly with the project maintainers and community members. 17 | 18 | # Reporting Issues 19 | 20 | We unfortunately receive a large number of false positive issues. We ask that you discuss potential problems in our [community forum](https://discourse.drone.io) before creating github issues. 21 | 22 | # IRC channel 23 | 24 | A community exists in an unofficial IRC channel on Freenode at [#drone-ci](https://webchat.freenode.net/?channels=drone-ci). 25 | 26 | While the community is happy to discuss any topic related to Drone, remember to create a topic in [Discourse](https://discourse.drone.io) if you need support. This has the advantage to benefit to everyone and not answer the same questions over and over again. 27 | -------------------------------------------------------------------------------- /content/install/users/user_admins.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "User Admins" 4 | url = "user-admins" 5 | 6 | [menu.install] 7 | weight = 2 8 | identifier = "user-admins" 9 | parent = "install_access" 10 | +++ 11 | 12 | You can grant administrative privileges to users by providing an enumerated user list, separated by a comma, using the designated environment variable. 13 | 14 | {{% alert %}} 15 | Admins can perform operations over any repository in Drone. 16 | {{% /alert %}} 17 | 18 | ```diff 19 | services: 20 | drone-server: 21 | image: drone/drone:{{% version %}} 22 | environment: 23 | + - DRONE_ADMIN=janedoe,johnsmith 24 | ``` 25 | 26 | Please note that the usernames are case-sensitive and must match the exact values as returned from your version control system (e.g. GitHub). 27 | 28 | # Access Privileged Endpoints 29 | 30 | View the server's metrics endpoint: 31 | 32 | ```nohighlight 33 | /metrics 34 | ``` 35 | 36 | View the server's queue endpoint: 37 | 38 | ```nohighlight 39 | /api/info/queue 40 | ``` 41 | 42 | View the server's pending and running builds endpoint: 43 | 44 | ```nohighlight 45 | /api/builds 46 | ``` 47 | 48 | # User management 49 | 50 | [Approving]({{< ref "install/users/user_access.md">}}) users for closed registrations and [managing]({{< ref "install/users/user_management.md">}}) users. 51 | -------------------------------------------------------------------------------- /content/api/repo/repo_update.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Repo Update" 4 | url = "api-repo-update" 5 | 6 | [menu.api] 7 | weight = 2 8 | identifier = "api-repo-update" 9 | parent = "api_repo" 10 | +++ 11 | 12 | Updates a named repository. 13 | Please note this api requires administrative access to the repository. 14 | 15 | ```text 16 | PATCH /api/repos/{owner}/{repo} 17 | ``` 18 | 19 | Example Request Body: 20 | 21 | ```json 22 | { 23 | "timeout": 60, 24 | "private": false, 25 | "trusted": false, 26 | "allow_pr": true, 27 | "allow_push": true, 28 | "allow_deploys": false, 29 | "allow_tags": false 30 | } 31 | ``` 32 | 33 | Example Response Body: 34 | 35 | ```json 36 | { 37 | "id": 1, 38 | "scm": "git", 39 | "owner": "octocat", 40 | "name": "hello-world", 41 | "full_name": "octocat/hello-world", 42 | "avatar_url": "https://avatars.githubusercontent.com/u/2181346?v=3", 43 | "link_url": "https://github.com/octocat/hello-world", 44 | "clone_url": "https://github.com/octocat/hello-world.git", 45 | "default_branch": "master", 46 | "timeout": 60, 47 | "private": false, 48 | "trusted": false, 49 | "allow_pr": true, 50 | "allow_push": true, 51 | "allow_deploys": false, 52 | "allow_tags": false, 53 | "visibility": "public", 54 | "gated": false, 55 | "active": true, 56 | "last_build": 0, 57 | "config_file": ".drone.yml" 58 | } 59 | ``` 60 | -------------------------------------------------------------------------------- /content/install/users/user_management.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "用户管理" 4 | url = "zh/user-management" 5 | 6 | [menu.install] 7 | weight = 2 8 | identifier = "user-management-zh" 9 | parent = "install_access" 10 | +++ 11 | 12 | 13 | 14 | 你可以使用命令行工具手动管理用户注册。请参考命令行文档来安装和配置命令行工具。 15 | 16 | 17 | 18 | 使用 `ls` 命令来列出所有活动用户： 19 | 20 | ```nohighlight 21 | drone user ls 22 | ``` 23 | 24 | 25 | 26 | 使用 `add` 命令来添加登录用户： 27 | 28 | ```nohighlight 29 | drone user add octocat 30 | ``` 31 | 32 | 33 | 34 | 使用 `rm` 命令来从系统删除用户： 35 | 36 | ```nohighlight 37 | drone user rm octocat 38 | ``` 39 | 40 | 41 | 42 | 注意只有 Drone 管理员可以管理用户。参考下面的例子来使用环境变量配置一个或者多个管理员，以英文逗号分隔。 43 | 44 | ```diff 45 | services: 46 | drone-server: 47 | image: drone/drone:{{% version %}} 48 | environment: 49 | + - DRONE_ADMIN=janedoe,johnsmith 50 | ``` 51 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_add.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret add" 4 | url = "cli-secret-add" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-secret-add" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | This subcommand adds a secret to your repository secret store. Please note this command requires administrative privilege to the repository. 13 | 14 | ```text 15 | {{< cat "content/cli/secret/data/drone_secret_add.out.txt" >}} 16 | ``` 17 | 18 | Example usage: 19 | 20 | ```text 21 | $ drone secret add \ 22 | --repository octocat/hello-world \ 23 | --name docker_password \ 24 | --value ... 25 | ``` 26 | 27 | Example usage limits the secret to a specific image: 28 | 29 | ```diff 30 | $ drone secret add \ 31 | --repository octocat/hello-world \ 32 | --name docker_password \ 33 | + --image plugins/docker \ 34 | --value ... 35 | ``` 36 | 37 | Example usage limits the secret to specific hook events: 38 | 39 | ```diff 40 | $ drone secret add \ 41 | --repository octocat/hello-world \ 42 | --name docker_password \ 43 | --image plugins/docker \ 44 | + --event push \ 45 | + --event pull_request \ 46 | + --event tag \ 47 | + --event deployment \ 48 | --value ... 49 | ``` 50 | 51 | Example usage adds the secret from a file: 52 | 53 | ```diff 54 | $ drone secret add \ 55 | --repository octocat/hello-world \ 56 | --name ssh_key \ 57 | + --value @/root/.ssh/id_rsa 58 | ``` 59 | -------------------------------------------------------------------------------- /content/faq/error_image_not_found.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2017-04-15T14:39:04+02:00 3 | title: "Error: image not found" 4 | url: error-image-not-found 5 | --- 6 | 7 | This error message comes from the Docker daemon when an image isn’t specified, or when the specified image cannot be downloaded. To further diagnose this error we recommend looking at the Docker daemon logs, since this is not a Drone issue. 8 | 9 | ```nohighlight 10 | Trying to pull foo/bar from https://registry-1.docker.io v2 11 | Trying to pull foo/bar from https://index.docker.io v1 12 | [registry] Calling GET https://index.docker.io/v1/repositories/foo/bar/images 13 | Not continuing with pull after error: Error: image foo/bar not found 14 | ``` 15 | 16 | Example failure when image does not exist, or has a typo: 17 | 18 | ```diff 19 | pipeline: 20 | build: 21 | - image: go 22 | + image: golang 23 | ``` 24 | 25 | Example failure when image tag does not exist, or has a typo: 26 | 27 | ```diff 28 | pipeline: 29 | build: 30 | - image: golang:latdst 31 | + image: golang:latest 32 | ``` 33 | 34 | Example failure when image is not declared: 35 | 36 | ```diff 37 | pipeline: 38 | build: 39 | - 40 | + image: golang:1.5 41 | ``` 42 | 43 | Example failure when image is private, but no registry credentials provided: 44 | 45 | 46 | ```diff 47 | pipeline: 48 | build: 49 | image: index.company.com/octocat/hello-image 50 | + auth_config: 51 | + username: octocat 52 | + password: password 53 | ``` 54 | -------------------------------------------------------------------------------- /content/api/build/build_info.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Build Info" 4 | url = "api-build-info" 5 | 6 | [menu.api] 7 | weight = 3 8 | identifier = "api-build-info" 9 | parent = "api_build" 10 | +++ 11 | 12 | Returns the specified repository build. 13 | Please note this api requires read access to the repository and the request parameter `{build}` is not the build id but the build number. 14 | 15 | ```text 16 | GET /api/repos/{owner}/{repo}/builds/{build} 17 | ``` 18 | 19 | Example Response Body: 20 | 21 | ```json 22 | { 23 | "id": 1, 24 | "number": 1, 25 | "parent": 0, 26 | "event": "push", 27 | "status": "success", 28 | "created_at": 1443677151, 29 | "enqueued_at": 1443677151, 30 | "started_at": 1443677151, 31 | "finished_at": 1443677255, 32 | "deploy_to": "", 33 | "commit": "2deb7e0d0cbac357eeb110c8a2f2f32ce037e0d5", 34 | "branch": "master", 35 | "ref": "refs/heads/master", 36 | "remote": "https://github.com/octocat/hello-world.git", 37 | "title": "", 38 | "message": "New line at end of file. --Signed off by Spaceghost", 39 | "timestamp": 1443677255, 40 | "sender": "Spaceghost", 41 | "author": "Spaceghost", 42 | "author_avatar": "https://avatars0.githubusercontent.com/u/251370?v=3", 43 | "author_email": "octocat@github.com", 44 | "link_url": "https://github.com/octocat/hello-world/commit/762941318ee16e59dabbacb1b4049eec22f0d303", 45 | "signed": false, 46 | "verified": true, 47 | "reviewed_by": "", 48 | "reviewed_at": 0 49 | } 50 | ``` 51 | -------------------------------------------------------------------------------- /content/api/build/build_list.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Build List" 4 | url = "api-build-list" 5 | 6 | [menu.api] 7 | weight = 4 8 | identifier = "api-build-list" 9 | parent = "api_build" 10 | +++ 11 | 12 | Returns recent builds for the repository based on name. 13 | Please note this api requires read access to the repository. 14 | 15 | ```text 16 | GET /api/repos/{owner}/{repo}/builds 17 | ``` 18 | 19 | Example Response Body: 20 | 21 | ```json 22 | [ 23 | { 24 | "id": 1, 25 | "number": 1, 26 | "parent": 0, 27 | "event": "push", 28 | "status": "success", 29 | "created_at": 1443677151, 30 | "enqueued_at": 1443677151, 31 | "started_at": 1443677151, 32 | "finished_at": 1443677255, 33 | "deploy_to": "", 34 | "commit": "2deb7e0d0cbac357eeb110c8a2f2f32ce037e0d5", 35 | "branch": "master", 36 | "ref": "refs/heads/master", 37 | "remote": "https://github.com/octocat/hello-world.git", 38 | "title": "", 39 | "message": "New line at end of file. --Signed off by Spaceghost", 40 | "timestamp": 1443677255, 41 | "sender": "Spaceghost", 42 | "author": "Spaceghost", 43 | "author_avatar": "https://avatars0.githubusercontent.com/u/251370?v=3", 44 | "author_email": "octocat@github.com", 45 | "link_url": "https://github.com/octocat/hello-world/commit/762941318ee16e59dabbacb1b4049eec22f0d303", 46 | "signed": false, 47 | "verified": true, 48 | "reviewed_by": "", 49 | "reviewed_at": 0 50 | } 51 | ] 52 | ``` 53 | -------------------------------------------------------------------------------- /content/install/server/caddy.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Setup with Caddy" 4 | url = "setup-with-caddy" 5 | 6 | [menu.install] 7 | identifier = "setup-with-caddy" 8 | parent = "install_server" 9 | weight = 4 10 | +++ 11 | 12 | This guide provides a brief overview for installing Drone server behind the [Caddy webserver](https://caddyserver.com/). This is an example caddyfile proxy configuration: 13 | 14 | ```nohighlight 15 | drone.mycompany.com { 16 | gzip { 17 | not /stream/ 18 | } 19 | proxy / localhost:8000 { 20 | websocket 21 | transparent 22 | } 23 | } 24 | ``` 25 | You must disable gzip compression for streamed data otherwise the live updates won't be instant: 26 | 27 | ```diff 28 | drone.mycompany.com { 29 | + gzip { 30 | + not /stream/ 31 | + } 32 | proxy / localhost:8000 { 33 | websocket 34 | transparent 35 | } 36 | } 37 | ``` 38 | 39 | You must configure the proxy to enable websocket upgrades: 40 | 41 | ```diff 42 | drone.mycompany.com { 43 | gzip { 44 | not /stream/ 45 | } 46 | proxy / localhost:8000 { 47 | + websocket 48 | transparent 49 | } 50 | } 51 | ``` 52 | 53 | You must configure the proxy to include `X-Forwarded` headers using the `transparent` directive: 54 | 55 | ```diff 56 | drone.mycompany.com { 57 | gzip { 58 | not /stream/ 59 | } 60 | proxy / localhost:8000 { 61 | websocket 62 | + transparent 63 | } 64 | } 65 | ``` 66 | -------------------------------------------------------------------------------- /content/install/releases/0.6.0-notes/gating.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "0.6.0 Gated Builds" 4 | url = "release-0.6.0-gating" 5 | +++ 6 | 7 | Drone adds __experimental__ support for gating your builds. You can enable gating for your repository in the user interface or with the following command: 8 | 9 | ```text 10 | drone repo update --gated=true 11 | ``` 12 | 13 | The default gating logic is very basic. If the repository is public, and the hook is a pull request, and the user is not the repository admin, then the pull request is blocked pending approval. This default logic is intended to help mitigate bad actors sending harmful pull requests to open source projects. 14 | 15 | # Customization 16 | 17 | The default gating logic is not going to be useful for many installations. We fully expect most organizations will need to customize this logic. To enable customization we have made gating pluggable. This means you will be able to supply your own custom logic, tailored to your organization's specific needs. 18 | 19 | Please note that we do not want to embed a complex approval engine inside of Drone. Nor do we want to embed your organizations custom approval logic in Drone. So please use plugins and please do not send pull requests that attempt to alter the default gating logic. 20 | 21 | # What's Next 22 | 23 | * Builtin logic should not require approval if pull request is sender has write access 24 | * Ability to permanently add users to a repository whitelist 25 | * Ability to permanently add users to a repository blacklist 26 | -------------------------------------------------------------------------------- /content/install/server/nginx.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Setup with Nginx" 4 | url = "setup-with-nginx" 5 | 6 | [menu.install] 7 | identifier = "setup-with-nginx" 8 | parent = "install_server" 9 | weight = 3 10 | +++ 11 | 12 | This guide provides a basic overview for installing Drone server behind the nginx webserver. For more advanced configuration options please consult the official nginx [documentation](https://www.nginx.com/resources/admin-guide/). 13 | 14 | Example configuration: 15 | 16 | ```nginx 17 | server { 18 | listen 80; 19 | server_name drone.example.com; 20 | 21 | location / { 22 | proxy_set_header X-Forwarded-For $remote_addr; 23 | proxy_set_header X-Forwarded-Proto $scheme; 24 | proxy_set_header Host $http_host; 25 | 26 | proxy_pass http://127.0.0.1:8000; 27 | proxy_redirect off; 28 | proxy_http_version 1.1; 29 | proxy_buffering off; 30 | 31 | chunked_transfer_encoding off; 32 | } 33 | } 34 | ``` 35 | 36 | You must configure the proxy to set `X-Forwarded` proxy headers: 37 | 38 | ```diff 39 | server { 40 | listen 80; 41 | server_name drone.example.com; 42 | 43 | location / { 44 | + proxy_set_header X-Forwarded-For $remote_addr; 45 | + proxy_set_header X-Forwarded-Proto $scheme; 46 | 47 | proxy_pass http://127.0.0.1:8000; 48 | proxy_redirect off; 49 | proxy_http_version 1.1; 50 | proxy_buffering off; 51 | 52 | chunked_transfer_encoding off; 53 | } 54 | } 55 | ``` 56 | -------------------------------------------------------------------------------- /content/cli/secret/drone_secret_add.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "drone secret add" 4 | url = "zh/cli-secret-add" 5 | 6 | [menu.cli] 7 | weight = 1 8 | identifier = "cli-secret-add-zh" 9 | parent = "cli_secret" 10 | +++ 11 | 12 | 13 | 14 | 这个子命令给仓库添加密文，这个子命令需要登录认证以及对应仓库的管理员权限。 15 | 16 | ```text 17 | {{< cat "content/cli/secret/data/drone_secret_add.out.txt" >}} 18 | ``` 19 | 20 | 使用示例： 21 | 22 | ```text 23 | $ drone secret add \ 24 | -repository octocat/hello-world \ 25 | -name docker_password \ 26 | -value ... 27 | ``` 28 | 29 | 30 | 31 | 限制只有指定镜像可以使用密文地示例： 32 | 33 | ```diff 34 | $ drone secret add \ 35 | -repository octocat/hello-world \ 36 | -name docker_password \ 37 | + -image plugins/docker \ 38 | -value ... 39 | ``` 40 | 41 | 42 | 43 | 限制只有指定 webhook 可以使用密文地示例： 44 | 45 | ```diff 46 | $ drone secret add \ 47 | -repository octocat/hello-world \ 48 | -name docker_password \ 49 | -image plugins/docker \ 50 | + -event push \ 51 | + -event pull_request \ 52 | + -event tag \ 53 | + -event deployment \ 54 | -value ... 55 | ``` 56 | 57 | 58 | 59 | 从文件读取密文地示例： 60 | 61 | ```diff 62 | $ drone secret add \ 63 | -repository octocat/hello-world \ 64 | -name ssh_key \ 65 | + -value @/root/.ssh/id_rsa 66 | ``` 67 | -------------------------------------------------------------------------------- /content/install/server/caddy.es.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Configuración con Caddy" 4 | url = "es/setup-with-caddy" 5 | 6 | [menu.install] 7 | identifier = "setup-with-caddy-es" 8 | parent = "install_server" 9 | weight = 4 10 | +++ 11 | 12 | Esta guía provee un vistazo rápido a la instalación de un servidor de Drone detrás de un servidor web Caddy. Éste es un archivo de configuración de proxy en Caddy: 13 | 14 | ```nohighlight 15 | drone.mycompany.com { 16 | gzip { 17 | not /stream/ 18 | } 19 | proxy / localhost:8000 { 20 | websocket 21 | transparent 22 | } 23 | } 24 | ``` 25 | 26 | Debe deshabilitar la compresión gzip para datos en stream, de lo contrario las actualizaciones en tiempo real no serán instantáneas: 27 | 28 | ```diff 29 | drone.mycomopany.com { 30 | + gzip { 31 | + not /stream/ 32 | + } 33 | proxy / localhost:8000 { 34 | websocket 35 | transparent 36 | } 37 | } 38 | ``` 39 | 40 | Debes configurar el proxy para habilitar la actualización de sockets web: 41 | 42 | ```diff 43 | drone.mycompany.com { 44 | gzip { 45 | not /stream/ 46 | } 47 | proxy / localhost:8000 { 48 | + websocket 49 | transparent 50 | } 51 | } 52 | ``` 53 | 54 | Debes configurar el proxy para incluir cabeceras `X-Forwarded` usando la directiva `transparent`: 55 | 56 | ```diff 57 | drone.mycompany.com { 58 | gzip { 59 | not /stream/ 60 | } 61 | proxy / localhost:8000 { 62 | websocket 63 | + transparent 64 | } 65 | } 66 | ``` 67 | -------------------------------------------------------------------------------- /content/usage/config/pipeline-conditions.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Pipeline Conditions" 4 | url = "pipeline-conditions" 5 | 6 | [menu.usage] 7 | weight = 2 8 | identifier = "pipeline-conditions" 9 | parent = "usage_config" 10 | +++ 11 | 12 | Drone supports defining conditional pipelines to skip commits based on the target branch. If the branch matches the `branches:` block the pipeline is executed, otherwise it is skipped. 13 | 14 | Example skipping a commit when the target branch is not master: 15 | 16 | ```diff 17 | pipeline: 18 | build: 19 | image: golang 20 | commands: 21 | - go build 22 | - go test 23 | 24 | +branches: master 25 | ``` 26 | 27 | Example matching multiple target branches: 28 | 29 | ```diff 30 | pipeline: 31 | build: 32 | image: golang 33 | commands: 34 | - go build 35 | - go test 36 | 37 | +branches: [ master, develop ] 38 | ``` 39 | 40 | Example uses glob matching: 41 | 42 | ```diff 43 | pipeline: 44 | build: 45 | image: golang 46 | commands: 47 | - go build 48 | - go test 49 | 50 | +branches: [ master, feature/* ] 51 | ``` 52 | 53 | Example includes branches: 54 | 55 | ```diff 56 | pipeline: 57 | build: 58 | image: golang 59 | commands: 60 | - go build 61 | - go test 62 | 63 | +branches: 64 | + include: [ master, feature/* ] 65 | ``` 66 | 67 | Example excludes branches: 68 | 69 | ```diff 70 | pipeline: 71 | build: 72 | image: golang 73 | commands: 74 | - go build 75 | - go test 76 | 77 | +branches: 78 | + exclude: [ develop, feature/* ] 79 | ``` 80 | -------------------------------------------------------------------------------- /themes/drone/LICENSE.md: -------------------------------------------------------------------------------- 1 | BSD 3-Clause License 2 | 3 | Copyright (c) 2017, Brad Rydzewski 4 | All rights reserved. 5 | 6 | Redistribution and use in source and binary forms, with or without 7 | modification, are permitted provided that the following conditions are met: 8 | 9 | * Redistributions of source code must retain the above copyright notice, this 10 | list of conditions and the following disclaimer. 11 | 12 | * Redistributions in binary form must reproduce the above copyright notice, 13 | this list of conditions and the following disclaimer in the documentation 14 | and/or other materials provided with the distribution. 15 | 16 | * Neither the name of the copyright holder nor the names of its 17 | contributors may be used to endorse or promote products derived from 18 | this software without specific prior written permission. 19 | 20 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 21 | AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 23 | DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 24 | FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25 | DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 26 | SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 27 | CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 28 | OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 29 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30 | -------------------------------------------------------------------------------- /content/api/build/build_logs.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2000-01-01T00:00:00+00:02" 3 | title = "Build Logs" 4 | url = "api-build-logs" 5 | 6 | [menu.api] 7 | weight = 5 8 | identifier = "api-build-logs" 9 | parent = "api_build" 10 | +++ 11 | 12 | Please note this api requires read access to the repository. 13 | 14 | ```text 15 | GET /api/repos/{owner}/{repo}/logs/{log}/{pid} 16 | ``` 17 | 18 | Example Response Body: 19 | 20 | ```json 21 | 22 | [ 23 | { 24 | "proc": "clone", 25 | "pos": 0, 26 | "out": "+ git init\n" 27 | }, 28 | { 29 | "proc": "clone", 30 | "pos": 1, 31 | "out": "Initialized empty Git repository in /drone/src/github.com/octocat/hello-world/.git/\n" 32 | }, 33 | { 34 | "proc": "clone", 35 | "pos": 2, 36 | "out": "+ git remote add origin https://github.com/octocat/hello-world.git\n" 37 | }, 38 | { 39 | "proc": "clone", 40 | "pos": 3, 41 | "out": "+ git fetch --no-tags origin +refs/heads/master:\n" 42 | }, 43 | { 44 | "proc": "clone", 45 | "pos": 4, 46 | "out": "From https://github.com/octocat/hello-world\n" 47 | }, 48 | { 49 | "proc": "clone", 50 | "pos": 5, 51 | "out": " * branch master -> FETCH_HEAD\n" 52 | }, 53 | { 54 | "proc": "clone", 55 | "pos": 6, 56 | "out": " * [new branch] master -> origin/master\n" 57 | }, 58 | { 59 | "proc": "clone", 60 | "pos": 7, 61 | "out": "+ git reset --hard -q 62126a02ffea3dabd7789e5c5407553490973665\n" 62 | }, 63 | { 64 | "proc": "clone", 65 | "pos": 8, 66 | "out": "+ git submodule update --init --recursive\n" 67 | } 68 | ] 69 | ``` 70 | -------------------------------------------------------------------------------- /content/faq/error_could_not_read_username_for.md: -------------------------------------------------------------------------------- 1 | --- 2 | date: 2017-04-15T14:39:04+02:00 3 | title: "Fatal: could not read Username for" 4 | url: error-could-not-read-username-for 5 | --- 6 | 7 | This error message happens when attempting to clone a repository that requires authentication, but authentication credentials are not available to the pipeline. 8 | 9 | ```nohighlight 10 | fatal: could not read Username for 'https://...': No such device or address 11 | exit status 128 12 | ``` 13 | 14 | Note that when properly configured, you should never need to provide drone with credentials to clone your repository. This is something Drone handles automatically. 15 | 16 | # Private Mode 17 | 18 | The most common root cause for this error message is when your version control server requires authentication to clone __public__ repositories, usually known as private mode. You will need to configure Drone accordingly. 19 | 20 | ```nohighlight 21 | GITHUB_PRIVATE_MODE=true 22 | GITLAB_PRIVATE_MODE=true 23 | GOGS_PRIVATE_MODE=true 24 | ``` 25 | 26 | Note that after making this change you will need to run the below command. This will instruct Drone to treat the repository as if it were private and to require authentication. 27 | 28 | ```nohighlight 29 | drone repo repair 30 | ``` 31 | 32 | # Public to Private 33 | 34 | The second most common root cause is when you change your repository from public to private. Note that after making this change you will need to run the below command. This will instruct Drone to treat the repository as if it were private and to require authentication. 35 | 36 | ```nohighlight 37 | drone repo repair 38 | ``` 39 | -------------------------------------------------------------------------------- /content/usage/concepts/plugins.zh.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Plugins 插件" 4 | url = "zh/using-plugins" 5 | 6 | [menu.usage] 7 | weight = 7 8 | identifier = "plugins-zh" 9 | parent = "usage_concepts" 10 | +++ 11 | 12 | 13 | 14 | 插件是执行预定义任务的容器，它们在工作流中被配置为步骤（steps）。插件可以用来部署代码，发布构建结果，发送通知以及部署其他更多的功能。 15 | 16 | 17 | 18 | Docker 和 Slack 插件工作流示例： 19 | 20 | ```yaml 21 | pipeline: 22 | build: 23 | image: golang 24 | commands: 25 | - go build 26 | - go test 27 | 28 | publish: 29 | image: plugins/docker 30 | repo: foo/bar 31 | tags: latest 32 | 33 | notify: 34 | image: plugins/slack 35 | channel: dev 36 | ``` 37 | 38 | # 插件隔离 39 | 40 | 41 | 42 | 插件在 Docker 容器中执行，它们与工作流中的其他步骤相互隔离。注意，插件挂载和共享当前工作区，因此它将可以访问对应源代码。 43 | 44 | # 插件市场 45 | 46 | 47 | 48 | 插件被打包和发布为 Docker 容器，它们在概念上和软件库类似（比如 npm），可以被在社区中发布和共享。可以在 [http://plugins.drone.io](http://plugins.drone.io) 找到一系列可用的插件。 49 | -------------------------------------------------------------------------------- /content/install/extensions/global_environ.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Global Environment" 4 | url = "configure-global-environment" 5 | 6 | [menu.install] 7 | identifier = "configure-global-environment" 8 | parent = "install_enterprise" 9 | weight = 7 10 | +++ 11 | 12 | {{% alert enterprise %}} 13 | This feature is only available in the [Enterprise expansion pack](https://drone.io/enterprise/) 14 | {{% /alert %}} 15 | 16 | The enterprise expansion pack provides support for global environment variables, sourced from a yaml file on your server. You should mount the environment file into your container and specify the path to the file in your configuration. 17 | 18 | Example server configuration: 19 | 20 | ```diff 21 | services: 22 | drone-server: 23 | image: drone/drone:{{% version %}} 24 | ports: 25 | - 80:8000 26 | volumes: 27 | - /var/lib/drone:/var/lib/drone/ 28 | + - /etc/drone-env.yml:/etc/drone-env.yml 29 | restart: always 30 | environment: 31 | + DRONE_GLOBAL_ENVIRON=/etc/drone-env.yml 32 | ``` 33 | 34 | Example environment file: 35 | 36 | ```nohighlight 37 | - name: GITHUB_USERNAME 38 | value: octocat 39 | - name: GITHUB_PASSWORD 40 | value: correct-horse-batter-staple 41 | ``` 42 | 43 | # Restricting Access 44 | 45 | You can restrict access to global environment variables based on repository name using the `repos` attribute. This is defined as an array list with glob support. 46 | 47 | ``` 48 | - name: GITHUB_USERNAME 49 | value: octocat 50 | repos: [ octocat/hello-world, github/* ] 51 | - name: GITHUB_PASSWORD 52 | value: correct-horse-batter-staple 53 | repos: [ octocat/hello-world, github/* ] 54 | ``` 55 | -------------------------------------------------------------------------------- /content/install/extensions/global_webhooks.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = "2017-04-15T14:39:04+02:00" 3 | title = "Global Webhooks" 4 | url = "configure-system-webhooks" 5 | 6 | [menu.install] 7 | identifier = "configure-system-webhooks" 8 | parent = "install_enterprise" 9 | weight = 8 10 | +++ 11 | 12 | {{% alert enterprise %}} 13 | This feature is only available in the [Enterprise expansion pack](https://drone.io/enterprise/) 14 | {{% /alert %}} 15 | 16 | The enterprise expansion pack provides support for global webhooks for internal system events. Notification are sent as HTTP POST requests to an endpoint of your choosing. 17 | 18 | Example server configuration: 19 | 20 | ```diff 21 | services: 22 | drone-server: 23 | image: drone/drone:{{% version %}} 24 | environment: 25 | + - DRONE_HOOK=http://localhost:4567/payload 26 | ``` 27 | 28 | Webhook requests are triggered for the following event types: 29 | 30 | Name | Description 31 | ------------|------------- 32 | `user` | any time a user is created or deleted 33 | `repo` | any time a repository is created or updated 34 | `build` | any time a build is created or updated 35 | 36 | Webhook requests contain the following special headers: 37 | 38 | Header | Description 39 | ----------------|------------- 40 | `X-Drone-Event` | name of the event that triggered this delivery 41 | 42 | Example delivery: 43 | 44 | ```nohighlight 45 | POST /payload HTTP/1.1 46 | 47 | Host: localhost:4567 48 | Content-Type: application/json 49 | Content-Length: 100 50 | X-Drone-Event: user 51 | 52 | { 53 | "action": "created", 54 | "user": { 55 | "id": 1, 56 | "login": "johnsmith", 57 | "active": true 58 | } 59 | } 60 | ``` 61 | --------------------------------------------------------------------------------