You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

ConfigConstants.java 8.4KB

DFS: A storage layer for JGit In practice the DHT storage layer has not been performing as well as large scale server environments want to see from a Git server. The performance of the DHT schema degrades rapidly as small changes are pushed into the repository due to the chunk size being less than 1/3 of the pushed pack size. Small chunks cause poor prefetch performance during reading, and require significantly longer prefetch lists inside of the chunk meta field to work around the small size. The DHT code is very complex (>17,000 lines of code) and is very sensitive to the underlying database round-trip time, as well as the way objects were written into the pack stream that was chunked and stored on the database. A poor pack layout (from any version of C Git prior to Junio reworking it) can cause the DHT code to be unable to enumerate the objects of the linux-2.6 repository in a completable time scale. Performing a clone from a DHT stored repository of 2 million objects takes 2 million row lookups in the DHT to locate the OBJECT_INDEX row for each object being cloned. This is very difficult for some DHTs to scale, even at 5000 rows/second the lookup stage alone takes 6 minutes (on local filesystem, this is almost too fast to bother measuring). Some servers like Apache Cassandra just fall over and cannot complete the 2 million lookups in rapid fire. On a ~400 MiB repository, the DHT schema has an extra 25 MiB of redundant data that gets downloaded to the JGit process, and that is before you consider the cost of the OBJECT_INDEX table also being fully loaded, which is at least 223 MiB of data for the linux kernel repository. In the DHT schema answering a `git clone` of the ~400 MiB linux kernel needs to load 248 MiB of "index" data from the DHT, in addition to the ~400 MiB of pack data that gets sent to the client. This is 193 MiB more data to be accessed than the native filesystem format, but it needs to come over a much smaller pipe (local Ethernet typically) than the local SATA disk drive. I also never got around to writing the "repack" support for the DHT schema, as it turns out to be fairly complex to safely repack data in the repository while also trying to minimize the amount of changes made to the database, due to very common limitations on database mutation rates.. This new DFS storage layer fixes a lot of those issues by taking the simple approach for storing relatively standard Git pack and index files on an abstract filesystem. Packs are accessed by an in-process buffer cache, similar to the WindowCache used by the local filesystem storage layer. Unlike the local file IO, there are some assumptions that the storage system has relatively high latency and no concept of "file handles". Instead it looks at the file more like HTTP byte range requests, where a read channel is a simply a thunk to trigger a read request over the network. The DFS code in this change is still abstract, it does not store on any particular filesystem, but is fairly well suited to the Amazon S3 or Apache Hadoop HDFS. Storing packs directly on HDFS rather than HBase removes a layer of abstraction, as most HBase row reads turn into an HDFS read. Most of the DFS code in this change was blatently copied from the local filesystem code. Most parts should be refactored to be shared between the two storage systems, but right now I am hesistent to do this due to how well tuned the local filesystem code currently is. Change-Id: Iec524abdf172e9ec5485d6c88ca6512cd8a6eafb
13 years ago
DFS: A storage layer for JGit In practice the DHT storage layer has not been performing as well as large scale server environments want to see from a Git server. The performance of the DHT schema degrades rapidly as small changes are pushed into the repository due to the chunk size being less than 1/3 of the pushed pack size. Small chunks cause poor prefetch performance during reading, and require significantly longer prefetch lists inside of the chunk meta field to work around the small size. The DHT code is very complex (>17,000 lines of code) and is very sensitive to the underlying database round-trip time, as well as the way objects were written into the pack stream that was chunked and stored on the database. A poor pack layout (from any version of C Git prior to Junio reworking it) can cause the DHT code to be unable to enumerate the objects of the linux-2.6 repository in a completable time scale. Performing a clone from a DHT stored repository of 2 million objects takes 2 million row lookups in the DHT to locate the OBJECT_INDEX row for each object being cloned. This is very difficult for some DHTs to scale, even at 5000 rows/second the lookup stage alone takes 6 minutes (on local filesystem, this is almost too fast to bother measuring). Some servers like Apache Cassandra just fall over and cannot complete the 2 million lookups in rapid fire. On a ~400 MiB repository, the DHT schema has an extra 25 MiB of redundant data that gets downloaded to the JGit process, and that is before you consider the cost of the OBJECT_INDEX table also being fully loaded, which is at least 223 MiB of data for the linux kernel repository. In the DHT schema answering a `git clone` of the ~400 MiB linux kernel needs to load 248 MiB of "index" data from the DHT, in addition to the ~400 MiB of pack data that gets sent to the client. This is 193 MiB more data to be accessed than the native filesystem format, but it needs to come over a much smaller pipe (local Ethernet typically) than the local SATA disk drive. I also never got around to writing the "repack" support for the DHT schema, as it turns out to be fairly complex to safely repack data in the repository while also trying to minimize the amount of changes made to the database, due to very common limitations on database mutation rates.. This new DFS storage layer fixes a lot of those issues by taking the simple approach for storing relatively standard Git pack and index files on an abstract filesystem. Packs are accessed by an in-process buffer cache, similar to the WindowCache used by the local filesystem storage layer. Unlike the local file IO, there are some assumptions that the storage system has relatively high latency and no concept of "file handles". Instead it looks at the file more like HTTP byte range requests, where a read channel is a simply a thunk to trigger a read request over the network. The DFS code in this change is still abstract, it does not store on any particular filesystem, but is fairly well suited to the Amazon S3 or Apache Hadoop HDFS. Storing packs directly on HDFS rather than HBase removes a layer of abstraction, as most HBase row reads turn into an HDFS read. Most of the DFS code in this change was blatently copied from the local filesystem code. Most parts should be refactored to be shared between the two storage systems, but right now I am hesistent to do this due to how well tuned the local filesystem code currently is. Change-Id: Iec524abdf172e9ec5485d6c88ca6512cd8a6eafb
13 years ago
DFS: A storage layer for JGit In practice the DHT storage layer has not been performing as well as large scale server environments want to see from a Git server. The performance of the DHT schema degrades rapidly as small changes are pushed into the repository due to the chunk size being less than 1/3 of the pushed pack size. Small chunks cause poor prefetch performance during reading, and require significantly longer prefetch lists inside of the chunk meta field to work around the small size. The DHT code is very complex (>17,000 lines of code) and is very sensitive to the underlying database round-trip time, as well as the way objects were written into the pack stream that was chunked and stored on the database. A poor pack layout (from any version of C Git prior to Junio reworking it) can cause the DHT code to be unable to enumerate the objects of the linux-2.6 repository in a completable time scale. Performing a clone from a DHT stored repository of 2 million objects takes 2 million row lookups in the DHT to locate the OBJECT_INDEX row for each object being cloned. This is very difficult for some DHTs to scale, even at 5000 rows/second the lookup stage alone takes 6 minutes (on local filesystem, this is almost too fast to bother measuring). Some servers like Apache Cassandra just fall over and cannot complete the 2 million lookups in rapid fire. On a ~400 MiB repository, the DHT schema has an extra 25 MiB of redundant data that gets downloaded to the JGit process, and that is before you consider the cost of the OBJECT_INDEX table also being fully loaded, which is at least 223 MiB of data for the linux kernel repository. In the DHT schema answering a `git clone` of the ~400 MiB linux kernel needs to load 248 MiB of "index" data from the DHT, in addition to the ~400 MiB of pack data that gets sent to the client. This is 193 MiB more data to be accessed than the native filesystem format, but it needs to come over a much smaller pipe (local Ethernet typically) than the local SATA disk drive. I also never got around to writing the "repack" support for the DHT schema, as it turns out to be fairly complex to safely repack data in the repository while also trying to minimize the amount of changes made to the database, due to very common limitations on database mutation rates.. This new DFS storage layer fixes a lot of those issues by taking the simple approach for storing relatively standard Git pack and index files on an abstract filesystem. Packs are accessed by an in-process buffer cache, similar to the WindowCache used by the local filesystem storage layer. Unlike the local file IO, there are some assumptions that the storage system has relatively high latency and no concept of "file handles". Instead it looks at the file more like HTTP byte range requests, where a read channel is a simply a thunk to trigger a read request over the network. The DFS code in this change is still abstract, it does not store on any particular filesystem, but is fairly well suited to the Amazon S3 or Apache Hadoop HDFS. Storing packs directly on HDFS rather than HBase removes a layer of abstraction, as most HBase row reads turn into an HDFS read. Most of the DFS code in this change was blatently copied from the local filesystem code. Most parts should be refactored to be shared between the two storage systems, but right now I am hesistent to do this due to how well tuned the local filesystem code currently is. Change-Id: Iec524abdf172e9ec5485d6c88ca6512cd8a6eafb
13 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277
  1. /*
  2. * Copyright (C) 2010, Mathias Kinzler <mathias.kinzler@sap.com>
  3. * Copyright (C) 2010, Chris Aniszczyk <caniszczyk@gmail.com>
  4. * Copyright (C) 2012-2013, Robin Rosenberg
  5. * and other copyright owners as documented in the project's IP log.
  6. *
  7. * This program and the accompanying materials are made available
  8. * under the terms of the Eclipse Distribution License v1.0 which
  9. * accompanies this distribution, is reproduced below, and is
  10. * available at http://www.eclipse.org/org/documents/edl-v10.php
  11. *
  12. * All rights reserved.
  13. *
  14. * Redistribution and use in source and binary forms, with or
  15. * without modification, are permitted provided that the following
  16. * conditions are met:
  17. *
  18. * - Redistributions of source code must retain the above copyright
  19. * notice, this list of conditions and the following disclaimer.
  20. *
  21. * - Redistributions in binary form must reproduce the above
  22. * copyright notice, this list of conditions and the following
  23. * disclaimer in the documentation and/or other materials provided
  24. * with the distribution.
  25. *
  26. * - Neither the name of the Eclipse Foundation, Inc. nor the
  27. * names of its contributors may be used to endorse or promote
  28. * products derived from this software without specific prior
  29. * written permission.
  30. *
  31. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
  32. * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
  33. * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  34. * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  35. * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  36. * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  37. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  38. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  39. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  40. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  41. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  42. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
  43. * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  44. */
  45. package org.eclipse.jgit.lib;
  46. /**
  47. * Constants for use with the Configuration classes: section names,
  48. * configuration keys
  49. */
  50. @SuppressWarnings("nls")
  51. public class ConfigConstants {
  52. /** The "core" section */
  53. public static final String CONFIG_CORE_SECTION = "core";
  54. /** The "branch" section */
  55. public static final String CONFIG_BRANCH_SECTION = "branch";
  56. /** The "remote" section */
  57. public static final String CONFIG_REMOTE_SECTION = "remote";
  58. /** The "diff" section */
  59. public static final String CONFIG_DIFF_SECTION = "diff";
  60. /** The "dfs" section */
  61. public static final String CONFIG_DFS_SECTION = "dfs";
  62. /** The "user" section */
  63. public static final String CONFIG_USER_SECTION = "user";
  64. /** The "gerrit" section */
  65. public static final String CONFIG_GERRIT_SECTION = "gerrit";
  66. /** The "workflow" section */
  67. public static final String CONFIG_WORKFLOW_SECTION = "workflow";
  68. /** The "submodule" section */
  69. public static final String CONFIG_SUBMODULE_SECTION = "submodule";
  70. /**
  71. * The "rebase" section
  72. *
  73. * @since 3.2
  74. */
  75. public static final String CONFIG_REBASE_SECTION = "rebase";
  76. /** The "gc" section */
  77. public static final String CONFIG_GC_SECTION = "gc";
  78. /** The "pack" section */
  79. public static final String CONFIG_PACK_SECTION = "pack";
  80. /**
  81. * The "fetch" section
  82. *
  83. * @since 3.3
  84. */
  85. public static final String CONFIG_FETCH_SECTION = "fetch";
  86. /**
  87. * The "pull" section
  88. *
  89. * @since 3.5
  90. */
  91. public static final String CONFIG_PULL_SECTION = "pull";
  92. /** The "algorithm" key */
  93. public static final String CONFIG_KEY_ALGORITHM = "algorithm";
  94. /** The "autocrlf" key */
  95. public static final String CONFIG_KEY_AUTOCRLF = "autocrlf";
  96. /** The "bare" key */
  97. public static final String CONFIG_KEY_BARE = "bare";
  98. /** The "excludesfile" key */
  99. public static final String CONFIG_KEY_EXCLUDESFILE = "excludesfile";
  100. /** The "filemode" key */
  101. public static final String CONFIG_KEY_FILEMODE = "filemode";
  102. /** The "logallrefupdates" key */
  103. public static final String CONFIG_KEY_LOGALLREFUPDATES = "logallrefupdates";
  104. /** The "repositoryformatversion" key */
  105. public static final String CONFIG_KEY_REPO_FORMAT_VERSION = "repositoryformatversion";
  106. /** The "worktree" key */
  107. public static final String CONFIG_KEY_WORKTREE = "worktree";
  108. /** The "blockLimit" key */
  109. public static final String CONFIG_KEY_BLOCK_LIMIT = "blockLimit";
  110. /** The "blockSize" key */
  111. public static final String CONFIG_KEY_BLOCK_SIZE = "blockSize";
  112. /** The "deltaBaseCacheLimit" key */
  113. public static final String CONFIG_KEY_DELTA_BASE_CACHE_LIMIT = "deltaBaseCacheLimit";
  114. /**
  115. * The "symlinks" key
  116. *
  117. * @since 3.3
  118. */
  119. public static final String CONFIG_KEY_SYMLINKS = "symlinks";
  120. /** The "streamFileThreshold" key */
  121. public static final String CONFIG_KEY_STREAM_FILE_TRESHOLD = "streamFileThreshold";
  122. /** The "remote" key */
  123. public static final String CONFIG_KEY_REMOTE = "remote";
  124. /** The "merge" key */
  125. public static final String CONFIG_KEY_MERGE = "merge";
  126. /** The "rebase" key */
  127. public static final String CONFIG_KEY_REBASE = "rebase";
  128. /** The "url" key */
  129. public static final String CONFIG_KEY_URL = "url";
  130. /** The "autosetupmerge" key */
  131. public static final String CONFIG_KEY_AUTOSETUPMERGE = "autosetupmerge";
  132. /** The "autosetuprebase" key */
  133. public static final String CONFIG_KEY_AUTOSETUPREBASE = "autosetuprebase";
  134. /**
  135. * The "autostash" key
  136. *
  137. * @since 3.2
  138. */
  139. public static final String CONFIG_KEY_AUTOSTASH = "autostash";
  140. /** The "name" key */
  141. public static final String CONFIG_KEY_NAME = "name";
  142. /** The "email" key */
  143. public static final String CONFIG_KEY_EMAIL = "email";
  144. /** The "false" key (used to configure {@link #CONFIG_KEY_AUTOSETUPMERGE} */
  145. public static final String CONFIG_KEY_FALSE = "false";
  146. /** The "true" key (used to configure {@link #CONFIG_KEY_AUTOSETUPMERGE} */
  147. public static final String CONFIG_KEY_TRUE = "true";
  148. /**
  149. * The "always" key (used to configure {@link #CONFIG_KEY_AUTOSETUPREBASE}
  150. * and {@link #CONFIG_KEY_AUTOSETUPMERGE}
  151. */
  152. public static final String CONFIG_KEY_ALWAYS = "always";
  153. /** The "never" key (used to configure {@link #CONFIG_KEY_AUTOSETUPREBASE} */
  154. public static final String CONFIG_KEY_NEVER = "never";
  155. /** The "local" key (used to configure {@link #CONFIG_KEY_AUTOSETUPREBASE} */
  156. public static final String CONFIG_KEY_LOCAL = "local";
  157. /** The "createchangeid" key */
  158. public static final String CONFIG_KEY_CREATECHANGEID = "createchangeid";
  159. /** The "defaultsourceref" key */
  160. public static final String CONFIG_KEY_DEFBRANCHSTARTPOINT = "defbranchstartpoint";
  161. /** The "path" key */
  162. public static final String CONFIG_KEY_PATH = "path";
  163. /** The "update" key */
  164. public static final String CONFIG_KEY_UPDATE = "update";
  165. /** The "compression" key */
  166. public static final String CONFIG_KEY_COMPRESSION = "compression";
  167. /** The "indexversion" key */
  168. public static final String CONFIG_KEY_INDEXVERSION = "indexversion";
  169. /**
  170. * The "hidedotfiles" key
  171. * @since 3.5
  172. */
  173. public static final String CONFIG_KEY_HIDEDOTFILES = "hidedotfiles";
  174. /** The "precomposeunicode" key */
  175. public static final String CONFIG_KEY_PRECOMPOSEUNICODE = "precomposeunicode";
  176. /** The "pruneexpire" key */
  177. public static final String CONFIG_KEY_PRUNEEXPIRE = "pruneexpire";
  178. /** The "mergeoptions" key */
  179. public static final String CONFIG_KEY_MERGEOPTIONS = "mergeoptions";
  180. /** The "ff" key */
  181. public static final String CONFIG_KEY_FF = "ff";
  182. /**
  183. * The "checkstat" key
  184. * @since 3.0
  185. */
  186. public static final String CONFIG_KEY_CHECKSTAT = "checkstat";
  187. /**
  188. * The "renamelimit" key in the "diff section"
  189. * @since 3.0
  190. */
  191. public static final String CONFIG_KEY_RENAMELIMIT = "renamelimit";
  192. /**
  193. * The "noprefix" key in the "diff section"
  194. * @since 3.0
  195. */
  196. public static final String CONFIG_KEY_NOPREFIX = "noprefix";
  197. /**
  198. * A "renamelimit" value in the "diff section"
  199. * @since 3.0
  200. */
  201. public static final String CONFIG_RENAMELIMIT_COPY = "copy";
  202. /**
  203. * A "renamelimit" value in the "diff section"
  204. * @since 3.0
  205. */
  206. public static final String CONFIG_RENAMELIMIT_COPIES = "copies";
  207. /**
  208. * The "renames" key in the "diff section"
  209. * @since 3.0
  210. */
  211. public static final String CONFIG_KEY_RENAMES = "renames";
  212. /**
  213. * The "prune" key
  214. *
  215. * @since 3.3
  216. */
  217. public static final String CONFIG_KEY_PRUNE = "prune";
  218. }