From: Eric Biggers <ebiggers@google.com>
To: tytso@mit.edu
Cc: fstests@vger.kernel.org, Eric Biggers <ebiggers@google.com>
Subject: [PATCH] [xfstests-bld] Remove redundant gce-xfstests documentation
Date: Fri, 23 Sep 2016 13:56:10 -0700 [thread overview]
Message-ID: <1474664172-84173-1-git-send-email-ebiggers@google.com> (raw)
README.GCE is no longer necessary because the same information, with
more details, can now be found in gce-xfstests.md.
Signed-off-by: Eric Biggers <ebiggers@google.com>
---
kvm-xfstests/README.GCE | 147 ------------------------------------------------
1 file changed, 147 deletions(-)
delete mode 100644 kvm-xfstests/README.GCE
diff --git a/kvm-xfstests/README.GCE b/kvm-xfstests/README.GCE
deleted file mode 100644
index 8634572..0000000
--- a/kvm-xfstests/README.GCE
+++ /dev/null
@@ -1,147 +0,0 @@
-
- Running xfstests on Google Compute Engine
-
-Getting a Google Compute Engine account
----------------------------------------
-
-If you don't have GCE account, you can go to https://cloud.google.com
-and sign up for a free trial. This will get you $300 dollars worth of
-credit which you can use over a 60 day period (as of this writing).
-Given that a full test costs around a $1.50, and a smoke test costs
-pennies, that should be enough for plenty of testing. :-)
-
-Configuration
--------------
-
-You will need to set up the following configuration parameters in
-~/.config/kvm-xfststs:
-
-GS_BUCKET The name of the Google Storage bucket which should be
- used by gce-xfstests. Your Google Compute Engine account
- must have access to read and write files in this bucket.
-
-GCE_PROJECT The name of Google Compute Engine project which should
- be used to create and run GCE instances and disks.
-
-GCE_ZONE The name of the Google Compute Engine zone which should
- be used by xfstests.
-
-GCE_KERNEL The pathname to kernel that should be used for gce-xfstests
- by default.
-
-If you have a sendgrid account, you can set the following
-configuration parameters in order to have reports e-mailed to you:
-
-GCE_SG_USER The username for the sendgrid account used to send email
-
-GCE_SG_PASS The password for the sendgrid account used to send email
-
-GCE_REPORT_EMAIL The email addressed for which test results should be
-sent.
-
-An example ~//.config/kvm-xfstests might look like this:
-
-GS_BUCKET=tytso-xfstests
-GCE_PROJECT=tytso-linux
-GCE_ZONE=us-central1-c
-GCE_KERNEL=/build/ext4-64/arch/x86/boot/bzImage
-
-
-Creating the image
-------------------
-
-You will need to install the following packages (debian package names
-used):
-
- jq xz-utils git autoconf2.59 libtool-bin automake libc6-dev
- gcc make e2fslibs-dev pkg-config gettext libpopt-dev
-
-You will also need to install the Google Cloud SDK.
-
-1) make ; make tarball
-
-2) cd kvm-xfstests/test-appliance ; ./gce-create-image
-
-Running gce-xfstests
---------------------
-
-Running gce-xfstests is much like kvm-xfstests; see the README file in
-this directory for more details.
-
-The gce-xfstests command also has a few other commands:
-
-gce-xfstests ssh INSTANCE
-
- Remotely login as root to a test instances. This is a
- convenience shorthand for: "gcloud compute --project
- GCE_PROJECT ssh root@INSTNACE --zone GCE_ZONE".
-
-gce-xfstests console INSTANCE
-
- Fetch the serial console from a test instance. This is a
- convenience shorthand for: "gcloud compute --project
- GCE_PROJECT get-serial-port-output INSTANCE --zone GCE_ZONE".
-
-gce-xfstests ls-instances [-l ]
-gce-xfstests ls-gce
-
- List the current test instances. With the -l option, it will
- list the current status of each instance.
-
- The ls-gce option is a convenience command for "gcloud compute
- --project GCE_PROJECT instances list --regexp ^xfstests.*"
-
- ALIAS: gce-xfstests ls
-
-gce-xfstests rm-instances INSTANCE
-gce-xfstests abort-instances INSTANCE
-
- Shut down the instance. The abort command will delete make
- sure the results disk to be deleted. If test kernel has hung,
- it may be useful to use "gce-xfstests console" to fetch the
- console, and then use "gce-xfstests rm" and examine the
- results disk before deleting it.
-
- ALIAS: gce-xfstests rm
- ALIAS: gce-xfstests abort
-
-gce-xfstests ls-disks
-
- List the GCE disks. This is a convenience command for "gcloud
- compute --project "$GCE_PROJECT" disks list --regexp
- ^xfstests.*"
-
- ALIAS: gce-xfstests ls-disk
-
-gce-xfstests rm-disks DISK
-
- Delete a specified GCE disk. This is a convenience command
- for "gcloud compute --project "$GCE_PROJECT" disks delete DISK"
-
-ALIAS: gce-xfstests rm-disk
-
-gce-xfstests ls-results
-gce-xfstests ls-gcs
-
- List the available results tarballs stored in the Google Cloud
- Storage bucket. This is a convenience command for
- "gsutil ls gs://GS_BUCKET/results.*" (ls-results) or
- "gsutil ls gs://GS_BUCKET" (ls-gcs).
-
-gce-xfstests rm-results RESULT_FILE
-
- Delete a specified result tarball. This is a convenience
- command for "gsutil ls gs://GS_BUCKET/RESULT_FILE".
-
-gce-xfstests get-results [--unpack | --summary | --failures ] RESULT_FILE
-
- Fetch the run-tests.log file from the RESULT_FILE stored in
- the Google Cloud Storage bucket. The --summary or --failures
- option will cause the log file to be piped into the
- "get-results" script to summarize the log file using the "-s"
- or "-F" option, respectively. The "--failures" or "-F" option
- results in a more succint summary than the "--summary" or "-s"
- option.
-
- The --unpack option will cause the complete results directory
- to be unpacked into a directory in /tmp instead.
--
2.8.0.rc3.226.g39d4020
next reply other threads:[~2016-09-23 20:56 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-09-23 20:56 Eric Biggers [this message]
2016-09-23 20:56 ` [PATCH] [xfstests-bld] Fix typos in xfstests-bld documentation Eric Biggers
2016-09-30 22:21 ` Theodore Ts'o
2016-09-23 20:56 ` [PATCH] [xfstests-bld] kvm-xfstests: forbid conflicting specifications of FSTESTCFG Eric Biggers
2016-09-30 22:21 ` Theodore Ts'o
2016-10-21 20:55 ` Eric Biggers
2016-10-21 21:37 ` Theodore Ts'o
2016-09-30 22:19 ` [PATCH] [xfstests-bld] Remove redundant gce-xfstests documentation Theodore Ts'o
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1474664172-84173-1-git-send-email-ebiggers@google.com \
--to=ebiggers@google.com \
--cc=fstests@vger.kernel.org \
--cc=tytso@mit.edu \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox