Index: third_party/gsutil/README.pkg |
diff --git a/third_party/gsutil/README.pkg b/third_party/gsutil/README.pkg |
new file mode 100644 |
index 0000000000000000000000000000000000000000..067ba71bd1b263ef743dfb0c6b9a8846272e4f5c |
--- /dev/null |
+++ b/third_party/gsutil/README.pkg |
@@ -0,0 +1,49 @@ |
+Package Generation Notes for gsutil |
+ |
+Gsutil can be distributed in one of three ways: |
+ |
+1. legacy mode - User unpacks archive file into a private directory tree |
+and maintains his/her own private copy of gsutil, boto, etc. This is the |
+only supported installation mode for Windows users. |
+ |
+2. enterprise mode - User unpacks the gsutil archive file and runs |
+'python setup.py install' (as root), which installs everything into |
+a shared directory tree (/usr/share/gsutil) with a symlink from |
+/usr/bin/gsutil to /usr/share/gsutil/gsutil to provide easy access to |
+the shared gsutil command. In enterprise mode, the software gets installed |
+in one shared location, which makes it easier to install, update and |
+manage gsutil for a community of users. |
+ |
+NOTE: Enterprise mode (installing gsutil via setup.py) is no longer |
+officially supported - unpacking the zip file into a directory is the |
+preferred method for installing gsutil for both shared and private |
+configurations. |
+ |
+3. rpm mode - User installs the gsutil rpm package file on a Red Hat |
+Linux system using the rpm command. The resulting installation image |
+looks precisely the same as the results of installing with enterprise |
+mode, i.e. a shared directory tree (/usr/share/gsutil) with a symlink |
+from /usr/bin/gsutil. rpm mode is intended for enterprises that want |
+a stable release that does not necessarily contain the latest changes. |
+ |
+All three modes derive their inventory from a common text file called |
+MANIFEST.in. If you want to add one or more new files or directories, |
+you only need to edit that one file and all three installation modes |
+will automatically inherit the change(s). |
+ |
+GENERATING PACKAGE FILES |
+ |
+First update the VERSION file and the gsutil.spec files to reflect the |
+new version number. |
+ |
+Legacy mode and enterprise mode are both embodied in the same gsutil |
+archive file, the only difference being that the latter entails running |
+one additional command after unpacking the gsutil archive file. So the |
+same archive file we've always distributed for gsutil will be used for |
+both legacy and enterprise installation modes. |
+ |
+For rpm mode, there's a new tool call pkg_gen.sh, which when run with no |
+arguments creates an rpm file at this location: |
+ |
+ $HOME/rpmbuild/RPMS/noarch/gsutil-2.0-1.noarch.rpm |
+ |