snapd

module
v0.0.0-...-7cedb2b Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 16, 2016 License: GPL-3.0

README

Build Status Coverage Status

snapd

The snapd and snap tools enable systems to work with .snap files.

Development

Setting up a GOPATH

When working with the source of Go programs, you should define a path within your home directory (or other workspace) which will be your GOPATH. GOPATH is similar to Java's CLASSPATH or Python's ~/.local. GOPATH is documented http://golang.org/pkg/go/build/ and inside the go tool itself

go help gopath

Various conventions exist for naming the location of your GOPATH, but it should exist, and be writable by you. For example

export GOPATH=${HOME}/work
mkdir $GOPATH

will define and create $HOME/work as your local GOPATH. The go tool itself will create three subdirectories inside your GOPATH when required; src, pkg and bin, which hold the source of Go programs, compiled packages and compiled binaries, respectively.

Setting GOPATH correctly is critical when developing Go programs. Set and export it as part of your login script.

Add $GOPATH/bin to your PATH, so you can run the go programs you install:

PATH="$PATH:$GOPATH/bin"
Getting the snappy sources

The easiest way to get the source for snappy is to use the go get command.

go get -d -v github.com/snapcore/snapd/...

This command will checkout the source of snappy and inspect it for any unmet Go package dependencies, downloading those as well. go get will also build and install snappy and its dependencies. To checkout without installing, use the -d flag. More details on the go get flags are available using

go help get

At this point you will have the git local repository of the snappy source at $GOPATH/github.com/snapcore/snapd. The source for any dependent packages will also be available inside $GOPATH.

Dependencies handling

To generate dependencies.tsv you need godeps, so

go get launchpad.net/godeps

To obtain the correct dependencies for the project, run:

godeps -t -u dependencies.tsv

You can use the script get-deps.sh to run the two previous steps.

If the dependencies need updating

godeps -t ./... > dependencies.tsv
Building

To build, once the sources are available and GOPATH is set, you can just run

go build -o /tmp/snap github.com/snapcore/snapd/cmd/snap

to get the snap binary in /tmp (or without -o to get it in the current working directory). Alternatively:

go install github.com/snapcore/snapd/...

to have it available in $GOPATH/bin

Contributing

Contributions are always welcome! Please make sure that you sign the Canonical contributor licence agreement at http://www.ubuntu.com/legal/contributors

Snappy can be found on Github, so in order to fork the source and contribute, go to https://github.com/snapcore/snapd. Check out Github's help pages to find out how to set up your local branch, commit changes and create pull requests.

We value good tests, so when you fix a bug or add a new feature we highly encourage you to create a test in $source_testing.go. See also the section about Testing.

Testing

To run the various tests that we have to ensure a high quality source just run:

./run-checks

This will check if the source format is consistent, that it build, all tests work as expected and that "go vet" and "golint" have nothing to complain.

You can run individual test with:

go test -check.f $testname

If a test hangs, you can enable verbose mode:

go test -v -check.vv

(or -check.v for less verbose output).

There is more to read about the testing framework on the website

Testing snapd on a snappy system

To test the snapd REST API daemon on a snappy system you need to transfer it to the snappy system and then run:

sudo systemctl stop snapd.service snapd.socket
sudo /lib/systemd/systemd-activate -E SNAPD_DEBUG=1 -l /run/snapd.socket ./snapd

This will stop the installed snapd and activate the new one. Once it's printed out something like Listening on /run/snapd.socket as 3. you should then

sudo chmod 0666 /run/snapd.socket

so the socket has the right permissions (otherwise you need sudo to connect).

Directories

Path Synopsis
Package asserts implements snappy assertions and a database abstraction for managing and holding them.
Package asserts implements snappy assertions and a database abstraction for managing and holding them.
assertstest
Package assertstest provides helpers for testing code that involves assertions.
Package assertstest provides helpers for testing code that involves assertions.
sysdb
Package sysdb supports the system-wide assertion database with ways to open it and to manage the trusted set of assertions founding it.
Package sysdb supports the system-wide assertion database with ways to open it and to manage the trusted set of assertions founding it.
systestkeys
Package systestkeys defines trusted assertions and keys to use in tests.
Package systestkeys defines trusted assertions and keys to use in tests.
cmd
apparmor
Package apparmor contains primitives for working with apparmor.
Package apparmor contains primitives for working with apparmor.
backendtest
package backendtest contains common code for testing backends
package backendtest contains common code for testing backends
dbus
Package dbus implements interaction between snappy and dbus.
Package dbus implements interaction between snappy and dbus.
mount
Package mount implements mounts that get mapped into the snap Snappy creates fstab like configuration files that describe what directories from the system or from other snaps should get mapped into the snap.
Package mount implements mounts that get mapped into the snap Snappy creates fstab like configuration files that describe what directories from the system or from other snaps should get mapped into the snap.
seccomp
Package seccomp implements integration between snappy and ubuntu-core-launcher around seccomp.
Package seccomp implements integration between snappy and ubuntu-core-launcher around seccomp.
udev
Package udev implements integration between snappy, udev and ubuntu-core-laucher around tagging character and block devices so that they can be accessed by applications.
Package udev implements integration between snappy, udev and ubuntu-core-laucher around tagging character and block devices so that they can be accessed by applications.
Package overlord implements the overall control of a snappy system.
Package overlord implements the overall control of a snappy system.
assertstate
Package assertstate implements the manager and state aspects responsible for the enforcement of assertions in the system and manages the system-wide assertion database.
Package assertstate implements the manager and state aspects responsible for the enforcement of assertions in the system and manages the system-wide assertion database.
hookstate
Package hookstate implements the manager and state aspects responsible for the running of hooks.
Package hookstate implements the manager and state aspects responsible for the running of hooks.
ifacestate
Package ifacestate implements the manager and state aspects responsible for the maintenance of interfaces the system.
Package ifacestate implements the manager and state aspects responsible for the maintenance of interfaces the system.
snapstate
Package snapstate implements the manager and state aspects responsible for the installation and removal of snaps.
Package snapstate implements the manager and state aspects responsible for the installation and removal of snaps.
snapstate/backend
Package backend implements the low-level primitives to manage the snaps and their installation on disk.
Package backend implements the low-level primitives to manage the snaps and their installation on disk.
state
Package state implements the representation of system state.
Package state implements the representation of system state.
Package policy provides helpers for keeping a framework's security policies up to date on install/remove.
Package policy provides helpers for keeping a framework's security policies up to date on install/remove.
snaptest
Package snaptest contains helper functions for mocking snaps.
Package snaptest contains helper functions for mocking snaps.
Package store has support to use the Ubuntu Store for querying and downloading of snaps, and the related services.
Package store has support to use the Ubuntu Store for querying and downloading of snaps, and the related services.
tests
lib/snapbuild
snapbuild is a minimal executable wrapper around snap building to use for integration tests that need to build snaps under sudo.
snapbuild is a minimal executable wrapper around snap building to use for integration tests that need to build snaps under sudo.
Package wrappers is used to generate wrappers and service units and also desktop files for snap applications.
Package wrappers is used to generate wrappers and service units and also desktop files for snap applications.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL