代码拉取完成，页面将自动刷新
| parent | nav_order |
|---|---|
| Testing with Kola | 1 |
{: .no_toc }
coreos-assembler repositorymantle/kola/tests/ and look for the package your test would best fitinit()If your test can be run as an external test (i.e. from a script which runs directly on the host), then that approach is preferred. Most likely, the test would live in the fedora-coreos-config repo (or if tightly coupled to a specific project, in that project's repo; there are plans to make those more consumable by FCOS/RHCOS).
If your test needs richer information about e.g. the cosa build, or multiple nodes, or more support code from outside the test subject, then adding a native kola test as described here is a better fit.
Say we wanted to add a simple noop test in the podman test package. If we follow the above instructions it would look like this:
$ git clone git@github.com:$GITHUB_USERNAME/coreos-assembler.git
<snip/>
$ cd mantle
$ pushd kola/tests/
$ $EDITOR podman/podman.go # Add the test
// Test: I'm a NOOP!
func podmanNOOP(c cluster.TestCluster) {
// NOOP!
}
$ $EDITOR podman/podman.go # Register the test in the init
func init() {
register.RegisterTest(®ister.Test{
Run: podmanNOOP,
ClusterSize: 1,
Name: `podman.noop`,
Distros: []string{"rhcos"},
Description: "Simple NOOP test for podman",
})
<snip/>
$ popd
$ ./build kola
# Check and ensure the test is there
$ ./bin/kola list | grep podman
podman.base [all] [all] [rhcos]
podman.network [all] [all] [rhcos]
podman.noop [all] [all] [rhcos]
podman.workflow [all] [all] [rhcos]
# Run your test and see what happens
$ ./bin/kola run -b rhcos --qemu-image rhcos-410.8.20190502.0-qemu.qcow2 podman.noop
=== RUN podman.noop
--- PASS: podman.noop (21.08s)
PASS, output in _kola_temp/qemu-2019-05-08-1535-16606
# git add/commit/push...
# Open PR to get the test added!
Sometimes it makes sense to group tests together under a specific package, especially when these tests are related and require the same test parameters. For kola it only takes a forwarding function to do testing groups. This forwarding function should take cluster.TestCluster as it's only input, and execute running other tests with cluster.TestCluster.Run().
It is worth noting that the tests within the group are executed sequentially and on the same machine. As such, it is not recommended to group tests which modify the system state.
Additionally, the FailFast flag can be enabled during the test registration to skip any remaining steps after a failure has occurred.
Continuing with the look at the podman package we can see that podman.base is registered like so:
register.RegisterTest(®ister.Test{
Run: podmanBaseTest,
ClusterSize: 1,
Name: `podman.base`,
Distros: []string{"rhcos"},
Description: "Verifies podman info and running with various options",
})
If we look at podmanBaseTest it becomes very obvious that it's not a test of it's own, but a group of tests.
func podmanBaseTest(c cluster.TestCluster) {
c.Run("info", podmanInfo)
c.Run("resources", podmanResources)
c.Run("network", podmanNetworksReliably)
}
If you need to add a new testing package there are few steps that must be done.
mantle/kola/tests/ which is descriptive of what will be tested.As an example, let's say you want to add a new test package called foo.
mantle/kola/tests/foo/echo "package foo" > mantle/kola/tests/foo/foo.gomantle/kola/registry/registry.go and add this to the imports _ "github.com/coreos/coreos-assembler/mantle/kola/tests/foo"package registry
// Tests imported for registration side effects. These make up the OS test suite and is explicitly imported from the main package.
import (
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/coretest"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/crio"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/docker"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/etcd"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/foo"
<snip/>
mantle/kola/tests/foo/foo.go adding in new test groups and tests.// Copyright 2019 Red Hat, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package foo
import (
"github.com/coreos/coreos-assembler/mantle/kola/cluster"
"github.com/coreos/coreos-assembler/mantle/kola/register"
)
// init runs when the package is imported and takes care of registering tests
func init() {
register.RegisterTest(®ister.Test{ // See: https://godoc.org/github.com/coreos/coreos-assembler/mantle/kola/register#Test
Run: exampleTestGroup,
ClusterSize: 1,
Name: `example.example`,
Flags: []register.Flag{}, // See: https://godoc.org/github.com/coreos/coreos-assembler/mantle/kola/register#Flag
Distros: []string{"rhcos"},
FailFast: true,
Description: "Example test group",
})
}
// exampleTestGroup groups all of the example.example tests together
func exampleTestGroup(c cluster.TestCluster) {
c.Run("test1", exampleTestOne)
c.Run("test2", exampleTestTwo)
}
// The first example test (and it does nothing!)
func exampleTestOne(c cluster.TestCluster) {
// NOOP!
}
// The second example test and it makes sure os-release has content
func exampleTestTwo(c cluster.TestCluster) {
// Get the first machine in the cluster
m := c.Machines()[0]
osrelease := c.MustSSH(m, `cat /etc/os-release`)
if string(osrelease) == "" {
c.Errorf("/etc/os-release was empty. Expected content.")
}
}
package registry
// Tests imported for registration side effects. These make up the OS test suite and is explicitly imported from the main package.
import (
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/coretest"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/crio"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/docker"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/etcd"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/flannel"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/foo"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/ignition"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/kubernetes"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/locksmith"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/metadata"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/misc"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/ostree"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/packages"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/podman"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/rkt"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/rpmostree"
_ "github.com/coreos/coreos-assembler/mantle/kola/tests/update"
)
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
马建仓 AI 助手
