canonical / multipass.run

Codebase for multipass marketing site

Multipass

Codebase for https://multipass.run - the marketing website for Canonical's multipass product.

Local development

The simplest way to run the site locally is to first install Docker (on Linux you may need to add your user to the docker group), and then use the ./run script:

./run

Once the containers are setup, you can visit http://127.0.0.1:8026 in your browser.

Building CSS

For working on Sass files, you may want to dynamically watch for changes to rebuild the CSS whenever something changes.

To setup the watcher, open a new terminal window and run:

./run watch

Deploy

You can find the deployment config in the deploy folder.

Licence

Code licensed LGPLv3 by Canonical Ltd..

With ♥ from Canonical

multipass.run's Issues

Confirm domain for multipass website

This may well be multipass.io, but we need to procure it first.

Replace sass-lint with stylelint

In a previous dev catchup it was decided that our projects should be updated to use stylelint instead of sass-lint which we are currently using.

Multipass.run site and u.c/downloads/multipass - UX & Design

brief https://docs.google.com/document/d/10BuGX8WN_-TZydf75ndXIWqaLdsgNVbn0wyN_uWqFgA/edit#heading=h.meo0azuz09li

Action Required: Fix Renovate Configuration

There is an error with this repository's Renovate configuration that needs to be fixed. As a precaution, Renovate will stop PRs until it is resolved.

Error type: undefined

No obvious link to report bugs on Multipass itself

1. Go to https://multipass.run/.
2. Try to find where to report a bug with Multipass.

What you see: Only a link to “Report a bug on this site”.

What you should see: A link to report a bug on Multipass itself as well.

Compare with the footer of snapcraft.io:

[Inspired by multipass.run#77.]

Deploy {staging.}multipass.io using Jenkins jobs

Create deploy-to-staging.multipass.io and deploy-to-multipass.io Jenkins jobs, and run them to deploy the sites to Kubernetes.

Broken `target=_blank` icons

#75 (comment) also shows a similar problem on earlier macOS?

Use qemu backing file instead of directly using the image

From what I understand multipass provides an abstraction which is somewhere between virsh for kvm and docker for containers but lacks a lot of features from both .

One good feature to have is provision to using a local image store similar to docker and the VM would use a backing file instead of directly using images from the store.

There should be abstractions for snapshoting VMs to create new images similar to the docker image layers . Publishing images to local / remote image stores . This would provide users an ecosystem for developing and sharing apps.

qemu-img info /var/snap/multipass/common/data/multipassd/vault/instances/thiru-test/ubuntu-18.04-server-cloudimg-amd64.img

image: /var/snap/multipass/common/data/multipassd/vault/instances/thiru-test/ubuntu-18.04-server-cloudimg-amd64.img
file format: qcow2
virtual size: 5.0G (5368709120 bytes)
disk size: 475M
cluster_size: 65536
Format specific information:
compat: 0.10
refcount bits: 16

Multipass.run: Rebuild based on the new copy

Todo

• Remove the install page
• Update the homepage to match the copy doc
• Remove all the client side functionality
• Move the auto download link generation on the homepage

New icons to use:
https://assets.ubuntu.com/v1/53c3be42-linuc-logo.svg
https://assets.ubuntu.com/v1/236f314d-macos.svg
https://assets.ubuntu.com/v1/11ecbd2d-2018-logo-windows.svg
mac 25px high, windows 33px high, linux 60px high

Include the Get it from the Snap store badge

On the Linux install instructions would be good to include the snap store badge:

to:

https://snapcraft.io/static/images/badges/en/snap-store-black.svg

add multipass on u.com/download/server

Non-link navigation items unindented on docs page

In https://multipass.run/docs

For links in navigation we have

padding-left: 1.5rem;

But not for plain text (think grouping under a common topic), which gets undented:

[COPY UPDATE] index.html - "Multipass is the fastest way to get Ubuntu VMs on Mac and Windows"

Please update index.html - "Multipass is the fastest way to get Ubuntu VMs on Mac and Windows" from the copy doc

ubuntu for MacBook Pro + Apple M1

Para cuando una version de ubuntu ARM para el MacBook Pro Apple M1???
Gracias.

For when a version of ubuntu ARM for the MacBook Pro Apple M1 ???
Thanks.

Add Ubuntu Pro tips Cheat sheet section/form

copy doc
Add a form for users to download cheat sheet same as https://ubuntu.com/download/server#

HTML below for section of landing page

  <div class="row u-equal-height u-vertically-center">
    <div class="col-6 u-align--center u-hide--small">
      <img src="https://assets.ubuntu.com/v1/39a8dac8-Ubuntu_Server_CLI_pro_tips_2020-04.jpg" style="width: 350px;" alt="Ubuntu Server CLI pro tips"/>
    </div>
    <div class="col-6">
      <p>The &rdquo;Ubuntu Server CLI cheat sheet&ldquo; is your fast path to learning the Linux command line - from basic file management to deploying Kubernetes and OpenStack.</p>
      <a class="p-button--positive js-invoke-modal" href="#">Download Cheat Sheet</a>
    </div>
  </div>
</section>

Wrong version selected for install

GitHub's API is ordering the releases in https://api.github.com/repositories/114128199/releases by draft creation date.

So if a draft for X was created before Y, even if they are released in reverse, the website would pick up X for download.

With the advent of /static/latest-release.json, we could read that instead, even if that's a temporary measure?

Multipass does not play well with VirtualBox on MacOS

I followed the instructions here:
https://multipass.run/docs/using-virtualbox-in-multipass-macos
and here:
https://multipass.run/docs/installing-on-macos
but multipass refuses to launch anything, claiming that:

launch failed: Conversion of image to VDI failed (Process returned exit code: 1) with the following output:
qemu-img: Unknown file format 'vdi'

I have updated VirtualBox on my Mac to the latest version earlier today.

I have tried the download-a-package route and (separately) the Homebrew route.

I have tried brew installing hyper kit before brew installing multipass.

I have tried running everything using sudo.

The problem seems to be the instruction:

$ sudo multipass set local.driver=virtualbox

Once this command has been executed, multipass is useless.

I instead executed this command to undo the one above:

$ sudo multipass set local.driver=hyperkit

Using hyperkit seems to work, but using virtualbox does not.

No command line reference for multipass transfer

multipass transfer is mentioned in the 'working with instances' page, but on the command line reference links itself there is not one for transfer.

Build the multipass install page

This task will include adding the navigation and links.

Copy doc: https://docs.google.com/document/d/1u8j5uN5d8qSEPDAjA03CGLeTJGf2p2MnHaKARkVmy7w/edit#heading=h.nel9e5tlwcfr

can't find link to download the server iso

Went to ubuntu.com/download/server and wound up here. Nowhere was there a link to download a version of the ubuntu server. WTF?

launch failed: Could not generate a new UUID: Process failed to start: 系统找不到指定的文件。

what's this problem?

Skip pre-releases when looking for installer links

We've just published a pre-release and that got picked up, but the website should only link to the latest final release.

Incorrect Windows / macOS download links

Hey,

Mark just noticed that 0.6.1 is linked to from multipass.run for Windows and macOS, and the latest release in fact is 0.7.0.

Something's gone wrong with the client-side version detection…

Add system requirements to download area

From Ubuntu-design#77:

On the multipass.run front page, the download buttons should be followed by small print describing the system requirements.

Before:

After:

@therealjuan commented on Jul 18, 2019
…
It will be more valuable to include further indication below the Linux / Snap section with something like Linux distributions with snap packages support enabled. [Get your Linux set up for snaps](https://docs.snapcraft.io/installing-snapd)

Build multipass homepage

@cristinadresch commented on Fri Mar 29 2019

---

@anasereijo commented on Fri Apr 12 2019

Hi @cristinadresch, not sure what this issue is for, can you please specify a bit more? thank you

---

@cristinadresch commented on Fri Apr 12 2019

This is the build for the multi pass website

On Fri, 12 Apr 2019 at 14:42, Ana Sereijo [email protected] wrote:

Hi @cristinadresch https://github.com/cristinadresch, not sure what
this issue is for, can you please specify a bit more? thank you

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
https://github.com/ubuntudesign/web-squad/issues/1063#issuecomment-482579074,
or mute the thread
https://github.com/notifications/unsubscribe-auth/AtwBVi98508-5iBNgHjR7atsJ0F6mQo7ks5vgI1BgaJpZM4cSkwm
.

---

@spencerbygraves commented on Thu Apr 18 2019

Here is the design for the homepage. When @waynecrosby has the final logo it will be added to the header and hero area.

windows 10 not support

Add version number

It would be nice if the website had the current version listed somewhere. Maybe in the "Install" section.

Multipass website: domain RT

./run failing on mac

Can't run the site locally to work on it - I've tried ./run clean but still getting the same error.

An unexpected error occurred: "/home/shared/.cache/yarn/v6/npm-meow-8.1.0-0fcaa267e35e4d58584b8205923df6021ddcc7ba-integrity/node_modules/meow/.yarn-metadata.json: Unexpected end of JSON input".

Nothing clickable to link to front-page headings

The h2 markup doesn't provide an id that can be used to link directly to sub headings like "Install" and "get started"

Update discourse module - multipass.run

Update discourse to canonicalwebteam.discourse==4.0.3 and replace document.html with new nav.

Add official Multipass logo

{staging.}multipass.run k8s deployment configs

Create deployment configs for staging.multipass.io and multipass.io.

Add search to docs

Home page https://multipass.run/ ... issue with second suggested command ? ...

Home page https://multipass.run/

suggests to run command:

multipass exec ubuntu-lts -- lsb_release -a

but this gives me result as per:

C:\Users\allan>multipass exec ubuntu-lts -- lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 20.04.1 LTS
Release: 20.04
Codename: focal

Is this command now out of date?

Switch DNS for {staging.}multipass.io

Ask IS to point the DNS for staging.multipass.io and multipass.io at prod-comms.kubernetes-ingress.canonical.com

Documentation suggests using Homebrew to install on macOS

Homebrew is spyware that transmits the user's activities to Google without consent.

Please do not recommend spyware.

Similar install instructions blocks as in snapcraft.io

Would be good to have a consistent element for install instructions between snapcraft.io and multipass.run.

The current ones on multipass.run are oversized.

Multipass website: visual design

Multipass website: UX copy review

Typo in Linux install instructions

https://multipass.run/install#linux-install

"Requirements:

A Linux distribution with supports for snaps"

should be "support for snaps" and maybe even consider linking to https://docs.snapcraft.io/installing-snapd/6735 ?

Incorrect information regarding the default version installed

We are now in July, more than 2 months after the official release of 20.04. https://multipass.run/ and https://snapcraft.io/multipass both report that "Launch an instance (by default you get the current Ubuntu LTS)" but I just did that and got a 18.04. Is there something I'm missing?

Missing commands from reference documentation

Approximately half of the commands are undocumented on this web page

$ multipass --version multipass 1.7.0+mac multipassd 1.7.0+mac

$ multipass --help
Usage: multipass [options] <command>
Create, control and connect to Ubuntu instances.

This is a command line utility for multipass, a
service that manages Ubuntu instances.

Options:
  -h, --help     Displays help on commandline options.
  --help-all     Displays help including Qt specific options.
  -v, --verbose  Increase logging verbosity. Repeat the 'v' in the short option
                 for more detail. Maximum verbosity is obtained with 4 (or more)
                 v's, i.e. -vvvv.

Available commands:
  delete    Delete instances
  exec      Run a command on an instance
  find      Display available images to create instances from
  get       Get a configuration setting
  help      Display help about a command
  info      Display information about instances
  launch    Create and start an Ubuntu instance
  list      List all available instances
  mount     Mount a local directory in the instance
  networks  List available network interfaces
  purge     Purge all deleted instances permanently
  recover   Recover deleted instances
  restart   Restart instances
  set       Set a configuration setting
  shell     Open a shell on a running instance
  start     Start instances
  stop      Stop running instances
  suspend   Suspend running instances
  transfer  Transfer files between the host and instances
  umount    Unmount a directory from an instance
  version   Show version details

Compared with the following on the webpage

Command-line reference
exec
find
get
help
info
launch
list
networks
set
shell
start
version

defer osselector and installversion scripts

We should use defer instead of async as we want the script to be run once the page finished parsing?

Install the snap should use snapcraft.io badge/embed

https://snapcraft.io/multipass should be linked via the embeddable card e.g. https://snapcraft.io/multipass/embedded?button=black

Seems this was added in #30 to fix #26 but regressed?

Create multipass.io codebase

Create the codebase to get a basic site running for multipass.io.

Update the multipass homepage with the latest content

Add HTTPS certs for {staging.}multipass.io

Ask IS to create HTTPS certs for staging.multipass.io and multipass.io, and put them in Kubernetes as secrets.

Cannot run on MacOS 10.13.6

on the site:

but on my mac:

Add cookie policy and update GTM

On the site

in package.json

"@canonical/cookie-policy": "3.0.2",

in templates/partial/_footer.html

<a href="" class="js-revoke-cookie-manager">Manage your tracker settings</a>

add the js (depends on site)

static/js/base.js

import { cookiePolicy } from "@canonical/cookie-policy";
cookiePolicy();

or

<script src="/static/js/modules/cookie-policy/cookie-policy.js"></script>
<script src="/static/js/modules/global-nav/global-nav.js"></script>
<script>
  canonicalGlobalNav.createNav({
    maxWidth: '72rem',
  });
  cpNs.cookiePolicy();
</script>

add to scss

static/sass/styles.scss

// import cookie policy
@import "@canonical/cookie-policy/build/css/cookie-policy";

On the GTM

1. add variable - _cookies_accepted
2. add trigger - All pages && cookie (all or functionality) - page view regex match (all|functionality)
   3.add trigger - All pages && cookie (all or performance) - regex match (all|performance)
3. add these to the triggers based on [this sheet](https://docs.google.com/spreadsheets/d/1PQEmbJPEG-76FLtLVOO271615V5aor66UhxfomZF-lo/edit#gid=0}
4. tracker track pageview for cookie acceptance for pageview
5. trigger - custom track pageview event on event pageview

performance

• ga
• crazyegg
• usabilla
• vimeo
• google optimise

functionality

• linked in
• livechat
• facebook
• twitter
• bombora
• google adwords
• Marketo Munchkin