34 Commits
Author SHA1 Message Date
Jim Garrison c9635c258d Install python3 specifically on CI
Following https://github.com/sandstorm-io/sandstorm/pull/3591#issuecomment-981153386
2021-11-28 18:27:26 -05:00
Jim Garrison 674a491c91 Update doc: Installing from source now requires python3
Recently, the clang update script [was changed](https://chromium.googlesource.com/chromium/src/tools/clang.git/+/5c0e867150ea239d3f0f0316370e71672c77b91a)
to require python3, specifically.

I discovered this change when attempting to build Sandstorm using a
[Dockerfile](https://gist.github.com/garrison/f025090ce914641f0d1e492612dcbd4e#file-dockerfile-debian)
that worked previously.  I have verified that this change
alone fixes the build under Debian; it seems that python2 is not
also required.

In Fedora, "python" already refers to python3, so no change was needed
to that install line.
2021-11-28 13:05:26 -05:00
Jim Garrison e27be25411 install.md: remove duplicate mention of strace
`git-blame` points to 6b0ad2716 (first mention) and e055782e1 (second mention).  Easy enough to fix.
2021-10-18 21:02:27 -04:00
Jim Garrison eeecef324d Add a workflow for previewing doc changes 2021-10-08 12:23:17 -04:00
Jim Garrison d2746d7cfb Use a requirements.txt file to specify doc dependencies
... following the don't-repeat-yourself (DRY) philosophy,
2021-10-08 12:20:46 -04:00
Jim Garrison 23be53beae Fix graphviz diagrams on "How It Works" page.
This fixes the diagrams by migrating to mkdocs-markdown-graphviz, following
https://github.com/sandstorm-io/sandstorm/pull/3548#issuecomment-898581699

I've tested this in a container locally, so hopefully it does indeed fix
things.
2021-10-07 19:06:54 -04:00
Jim Garrison 6f386d84db Vagrantfile: Set upper bound of 3GB RAM
Systems have more and more RAM these days, and using 1/4 of the
system RAM seems quite overkill in many cases.

With this change, a user can tweak either the desired fraction of RAM,
the lower bound, or the upper bound, each by adjusting a single number.
2021-10-07 03:38:57 -04:00
Jim Garrison 19c2745f38 Vagrantfile: Provision with DEBIAN_FRONTEND=noninteractive
Prior to this change, provisioning a machine would emit the warning:

    dpkg-reconfigure: unable to re-open stdin: No file or directory
2021-09-28 20:43:11 -04:00
Jim Garrison b1b10490b0 Vagrantfile: Disable UDP as NFS transport
Beginning with the upgrade to bullseye (1d50c1ec), I now get the following error
when using Virtualbox as a provider:

    The following SSH command responded with a non-zero exit status.
    Vagrant assumes that this means the command failed!

    mount -o vers=3,udp 169.254.254.1:/home/garrison/src/sandstorm /vagrant

    Stderr from the command:

    mount.nfs: an incorrect mount option was specified

I have thus disabled UDP as a transport protocol following
https://www.vagrantup.com/docs/synced-folders/nfs
2021-09-28 10:55:07 -04:00
Jim Garrison 7b265d6426 Vagrantfile: Create a private network only on virtualbox
The block in question gets evaluated regardless of virtualization provider,
and prior to this change, its presence would cause the following error
under libvirt:

    Network 192.254.254.2 is not available. Specify available network
    name, or an ip address if you want to create a new network.

This change adjusts it so the network is only created under virtualbox.

Note that, under libvirt, this private network does not even seem to be
necessary to achieve an NFS share.  Excerpt from the output on such a machine:

    ==> default: Installing NFS client...
    ==> default: Exporting NFS shared folders...
    ==> default: Preparing to edit /etc/exports. Administrator privileges will be required...
    [sudo] password for garrison:
    ==> default: Mounting NFS shared folders...
2021-09-27 21:23:54 -04:00
Jim Garrison 027262ecb1 Vagrantfile: Install gpg
This allows Sandstorm's `install.sh` to avoid emitting the follow warning:
```
WARNING: gpg not installed; not verifying signatures (but it's HTTPS so you're probably fine)
```
2021-09-27 21:21:58 -04:00
Jim Garrison 343c8173f7 Vagrantfile: Accept connections only from localhost
As the comment prior to this line says, the entire point of it is for
the development instance to be available at 127.0.0.1:6080, so this
change seems appropriate.

Here are some explanatory comments, lifted from the default `Vagrantfile`
created by running `vagrant init`:

```ruby
  # NOTE: This will enable public access to the opened port
  # config.vm.network "forwarded_port", guest: 80, host: 8080

  # Create a forwarded port mapping which allows access to a specific port
  # within the machine from a port on the host machine and only allow access
  # via 127.0.0.1 to disable public access
  # config.vm.network "forwarded_port", guest: 80, host: 8080, host_ip: "127.0.0.1"
```
2021-09-27 21:08:37 -04:00
Jim Garrison 1d50c1ec59 Vagrantfile: Upgrade to Debian bullseye base box
Bullseye is the current "stable" release and is two releases beyond stretch.
The `contrib-` is no longer necessary because the `vboxsf` kernel module is
included in `debian/bullseye64` (previous discussion in #3564).
2021-09-27 20:40:39 -04:00
Jim Garrison 64ad60855c Vagrantfile: Add user vagrant to sandstorm group
This will e.g. allow one to `spk dev` from within the VM.  This command is
consistently one of the first things I do after provisioning a new VM.
2021-09-27 20:38:23 -04:00
Jim Garrison 9f5df3bcda Fix typo on login providers page 2021-09-24 22:46:50 -04:00
Jim Garrison f10fe15629 install.sh: unset SANDCATS_REGISTRATION_EMAIL before recursion 2021-09-24 22:10:15 -04:00
Jim Garrison b2a1eaacc4 install.sh: unset DESIRED_SANDCATS_NAME as appropriate
i.e., before calling sandcats_register_name recursively
2021-09-24 22:05:18 -04:00
Jim Garrison 8c8c49fb6f Clarify Referrer-Policy comment on using same-origin 2021-09-24 20:14:42 -04:00
Jim Garrison 202c0edf28 Set Referrer-Policy: same-origin
Closes #824.
2021-09-23 21:52:16 -04:00
Jim Garrison dc9ff4ba45 Improve docs regarding test suite
- Add instructions for installing xvfb
- Add instructions for installing test dependencies on Fedora
- Mention tests/README.md in docs/install.md
2021-09-20 20:27:50 -04:00
Jim Garrison 0f117c88c1 Update build instructions for Fedora (closes #3565) 2021-09-19 22:29:43 -04:00
Jim Garrison 14d3775984 Update documentation on installing from source
- flex and bison are required for the build.

- locales is required under Debian/Ubuntu; otherwise the build fails
  because /usr/share/i18n/charmaps is missing.

- bullseye is now the latest Debian stable release.  The source build
fails on stretch because SECCOMP_FILTER_FLAG_LOG is undeclared, unless
(presumably) the kernel headers were to be upgraded.  (See also 2021-09-06
discussion on IRC.)  The `contrib-` is no longer necessary because
the vboxsf kernel module is in debian/bullseye64.
2021-09-16 20:22:26 -04:00
Jim Garrison 8cf0559543 Fix typo in install-script.md 2021-09-04 09:27:06 -04:00
Jim Garrison 3bd23d442e Pass plugin flag to stodgy-tester 2021-09-04 07:51:00 -04:00
Jim Garrison 944ac92d18 Document non-interactive production server install 2021-09-04 07:26:15 -04:00
Jim Garrison b2d3851896 install.sh cleanup: Remove SANDCATS_GETCERTIFICATE and sandcats_configure_https
sandcats_configure_https is dead code, as of 9ac0360311

In the current install script, the only effect of the value of
SANDCATS_GETCERTIFICATE is to conditionally tell
the user that we're going to "Configure auto-renewing HTTPS if you use
a subdomain of sandcats.io", so going forward we just provide this message
always on a full server install.
2021-09-04 07:25:56 -04:00
Jim Garrison 874a5b0592 Update installer-tests/README.md to refer to stodgy-tester
This updates the README following 813e7f4468.

It also sets the mode of prepare-for-tests.sh to be 755, so that
it will work when invoked as ./prepare-for-tests.sh, as the README says.
2021-09-03 23:32:44 -04:00
Jim Garrison de7c1ec47b install.sh: Use words (not numbers) for CHOSEN_INSTALL_MODE interface 2021-08-27 21:50:40 -04:00
Jim Garrison 9936706b59 Vagrantfile: apt-get update before install
Prior to this change, I got 404 errors for both curl and libcurl3
2021-08-27 16:36:08 -04:00
Jim Garrison 8feb7b2aa0 Fix #3536, graphviz on "How it Works" page 2021-08-10 22:35:20 -04:00
Jim Garrison a40d8c363a Doc: Update recommendation of Ubuntu 14.04
I also updated the minimum kernel version following 54c50a272
2021-08-09 20:18:36 -04:00
Jim Garrison 6c39faf272 Allow non-interactive full server install via environment variables
Fixes #3427
2021-07-28 21:33:33 -04:00
Jim Garrison 3684125629 Update doc link to allowed non-web-browser User-Agent strings
This updates the documentation following the change in
4edb2aeb17 (#3038).
2021-07-27 21:37:58 -04:00
Jim Garrison cbeec51951 Update docs: Remove mention of Sandcats HTTPS certificate service
Use of this service was removed in Sandstorm v0.269.
2020-09-01 21:38:40 -04:00