featureprofiles

module
v0.0.0-...-e8efe0d Latest Latest
Warning

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

 Go to latest Published: Feb 28, 2025 License: Apache-2.0

README

Feature Profiles

Feature profiles defines groups of OpenConfig paths that can be invoked on network devices. A feature profile may contain configuration, telemetry, operational or any other paths that a device exposes. Example management plane device APIs are gNMI, and gNOI. Example control plane APIs are gRIBI, and protocols such as BGP, IS-IS.

Feature profiles also includes a suite of Ondatra tests for validating the network device behavior for each defined feature. If you are new to Ondatra, please start by reading the Ondata README and taking the Ondatra tour.

Contributing

For information about how to contribute to OpenConfig Feature Profiles, please see Contributing to OpenConfig Feature Profiles.

Feedback and suggestions to improve OpenConfig Feature Profiles is welcomed on the public mailing list, or by opening a GitHub issue.

Running Tests on Virtual Devices

Warning: Though we are trying to use RFC defined non-globally routable space in tests, there might be tests (e.g. scaling tests) that are still using public routable ranges. Users who run the tests own the responsibility of not leaking test traffic to internet.

Tests may be run on virtual devices using the Kubernetes Network Emulation binding.

First, follow the steps for deploying a KNE cluster. Then follow the per-vendor instructions below for creating a KNE topology and running a test on it.

Arista

cEOS

Arista cEOS images can be obtained by contacting Arista.

  1. Create the topology:
kne create topologies/kne/arista/ceos/topology.textproto
  1. Run a sample test:
go test ./feature/example/tests/... -kne-topo $PWD/topologies/kne/arista/ceos/topology.textproto -vendor_creds ARISTA/admin/admin
  1. Cleanup:
kne delete topologies/kne/arista/ceos/topology.textproto

Cisco

8000e

NOTE: 8000e images require the host supports nested virtualization.

Cisco 8000e images can be obtained by contacting Cisco.

  1. Create the topology:
kne create topologies/kne/cisco/8000e/topology.textproto
  1. Run a sample test:
go test ./feature/example/tests/... -kne-topo $PWD/topologies/kne/cisco/8000e/topology.textproto -vendor_creds CISCO/cisco/cisco123
  1. Cleanup:
kne delete topologies/kne/cisco/8000e/topology.textproto
XRD

Cisco XRD images can be obtained by contacting Cisco.

  1. Create the topology:
kne create topologies/kne/cisco/xrd/topology.textproto
  1. Run a sample test:
go test ./feature/example/tests/... -kne-topo $PWD/topologies/kne/cisco/xrd/topology.textproto -vendor_creds CISCO/cisco/cisco123
  1. Cleanup:
kne delete topologies/kne/cisco/xrd/topology.textproto

Juniper

ncPTX

Juniper ncPTX images can be obtained by contacting Juniper.

  1. Create the topology:
kne create topologies/kne/juniper/ncptx/topology.textproto
  1. Run a sample test:
go test ./feature/example/tests/... -kne-topo $PWD/topologies/kne/juniper/ncptx/topology.textproto -vendor_creds JUNIPER/root/Google123
  1. Cleanup:
kne delete topologies/kne/juniper/ncptx/topology.textproto

Nokia

SR Linux

SR Linux images can be found here.

  1. Create the topology:
kne create topologies/kne/nokia/srlinux/topology.textproto
  1. Run a sample test:
go test ./feature/example/tests/... -kne-topo $PWD/topologies/kne/nokia/srlinux/topology.textproto -vendor_creds NOKIA/admin/admin
  1. Cleanup:
kne delete topologies/kne/nokia/srlinux/topology.textproto

Running Tests on Real Hardware

Tests may be run on real hardware devices using the static binding.

The static binding supports the testbeds in the topologies/*.testbed files. The mapping between the IDs in the testbed file and the physical devices are provided by the corresponding topologies/*.binding files. To try it out, edit otgdut_4.binding to specify the mapping from testbed IDs to actual hardware devices, as well as the desired protocol dial options. Then test it by running:

go test ./feature/example/tests/topology_test -binding $PWD/topologies/otgdut_4.binding

Path validation

The make validate_paths target will clone the public OpenConfig definitions and report Feature Profiles that have invalid OpenConfig paths.

Directories

Path Synopsis
feature
gribi/mplsutil
Package mplsutil implements a set of helper utility to run common gRIBI MPLS test scenarios against an ATE and DUT.
 Package mplsutil implements a set of helper utility to run common gRIBI MPLS test scenarios against an ATE and DUT.
system/gnmi/benchmarking/internal/setup
Package setup is scoped only to be used for scripts in path feature/experimental/system/gnmi/benchmarking/ate_tests/ Do not use elsewhere.
 Package setup is scoped only to be used for scripts in path feature/experimental/system/gnmi/benchmarking/ate_tests/ Do not use elsewhere.
internal
args
Package args define arguments for testing that depend on the available components and their naming on the device, if they cannot be enumerated easily from /components by type.
 Package args define arguments for testing that depend on the available components and their naming on the device, if they cannot be enumerated easily from /components by type.
attrs
Package attrs bundles some common interface attributes and provides helpers to generate the appropriate OpenConfig and ATETopology.
 Package attrs bundles some common interface attributes and provides helpers to generate the appropriate OpenConfig and ATETopology.
cfgplugins
Package cfgplugins is a collection of OpenConfig configuration libraries.
 Package cfgplugins is a collection of OpenConfig configuration libraries.
check
Package check provides validation helpers for ygnmi queries.
 Package check provides validation helpers for ygnmi queries.
cntrsrv
Binary cntrserver implements the Cntr (Container) service which can be used to test base functionalities of a container hosting device.
 Binary cntrserver implements the Cntr (Container) service which can be used to test base functionalities of a container hosting device.
cntrsrv/proto/cntr
components
Package components provides functions to enumerate components from the device.
 Package components provides functions to enumerate components from the device.
confirm
Package confirm provides experimental assertion helpers.
 Package confirm provides experimental assertion helpers.
core
Package core provides a validator for being able to check for core files on DUT's before and after test modules runs.
 Package core provides a validator for being able to check for core files on DUT's before and after test modules runs.
deviations
Package deviations defines the arguments to enable temporary workarounds for the featureprofiles test suite using command line flags.
 Package deviations defines the arguments to enable temporary workarounds for the featureprofiles test suite using command line flags.
encapfrr
Package encapfrr contains utility functions for encap frr using repair VRF.
 Package encapfrr contains utility functions for encap frr using repair VRF.
fptest
Package fptest provides helper functions for organizing tests and reporting results.
 Package fptest provides helper functions for organizing tests and reporting results.
gnoi
Package gnoi provides utilities for interacting with the gNOI API.
 Package gnoi provides utilities for interacting with the gNOI API.
gribi
Package gribi provides helper APIs to simplify writing gribi test cases.
 Package gribi provides helper APIs to simplify writing gribi test cases.
helpers
Package helpers provides helper APIs to simplify writing FP test cases.
 Package helpers provides helper APIs to simplify writing FP test cases.
iputil
Package iputil provides utilities for IPv4/IPv6 related utils
 Package iputil provides utilities for IPv4/IPv6 related utils
isissession
Package isissession is deprecated and scoped only to be used with feature/experimental/isis/ate_tests/*.
 Package isissession is deprecated and scoped only to be used with feature/experimental/isis/ate_tests/*.
metadata
Package metadata makes the data in metadata.textproto available.
 Package metadata makes the data in metadata.textproto available.
otg_helpers/otg_config_helpers
Package otgconfighelpers provides helper functions to setup Protocol configurations on traffic generators.
 Package otgconfighelpers provides helper functions to setup Protocol configurations on traffic generators.
otg_helpers/otg_validation_helpers
Package otgvalidationhelpers provides helper functions to validate OTG attributes for OTG tests.
 Package otgvalidationhelpers provides helper functions to validate OTG attributes for OTG tests.
otgutils
Package otgutils provides helpers for OTG configuration and telemetry.
 Package otgutils provides helpers for OTG configuration and telemetry.
p4rtutils
Package p4rtutils implements helper functions for acl_wbb_ingress_table in p4info file.
 Package p4rtutils implements helper functions for acl_wbb_ingress_table in p4info file.
pathutil
Package pathutil provides utilities for finding test-relative paths at runtime.
 Package pathutil provides utilities for finding test-relative paths at runtime.
qoscfg
Package qoscfg provides utilities for configure QoS across vendors.
 Package qoscfg provides utilities for configure QoS across vendors.
rundata
Package rundata collects the runtime data from the test environment.
 Package rundata collects the runtime data from the test environment.
samplestream
Package samplestream provides utilities for creating gNMI Subscriptions in SAMPLE mode.
 Package samplestream provides utilities for creating gNMI Subscriptions in SAMPLE mode.
security/acctz
Package acctz provides helper APIs to simplify writing acctz test cases.
 Package acctz provides helper APIs to simplify writing acctz test cases.
security/authz
Package authz provides helper APIs to simplify writing authz test cases.
 Package authz provides helper APIs to simplify writing authz test cases.
security/credz
Package credz provides helper APIs to simplify writing credentialz test cases.
 Package credz provides helper APIs to simplify writing credentialz test cases.
security/gen
package main generate data structure and skeleton function for all rpc related to fp.
 package main generate data structure and skeleton function for all rpc related to fp.
security/gnxi
Package gnxi populates a list of all RPCs related for featuresprofile tests.
 Package gnxi populates a list of all RPCs related for featuresprofile tests.
security/svid
Package svid provides functions to generate and sign SVID.
 Package svid provides functions to generate and sign SVID.
system
Package system provides helper functions for gNMI system related operations.
 Package system provides helper functions for gNMI system related operations.
tescale
Package tescale provides functions for tescale
 Package tescale provides functions for tescale
vrfpolicy
Package vrfpolicy contains functions to build specific vrf policies
 Package vrfpolicy contains functions to build specific vrf policies
proto
feature_go_proto
metadata_go_proto
nosimage_go_proto
ocpaths_go_proto
ocrpcs_go_proto
testregistry_go_proto
validate_paths inspects paths in the Feature Profiles and fails if any are not standard OpenConfig paths.
 validate_paths inspects paths in the Feature Profiles and fails if any are not standard OpenConfig paths.
addrundata
Command addrundata adds or updates rundata reporting to all tests in the source code, based on each of their README.md.
 Command addrundata adds or updates rundata reporting to all tests in the source code, based on each of their README.md.
ci-trigger
ci-trigger is a Google Cloud Run container that manages FeatureProfiles CI events.
 ci-trigger is a Google Cloud Run container that manages FeatureProfiles CI events.
ci-trigger/hwgcebind
Package hwgcebind is a placeholder to include additional dependencies into go.mod.
 Package hwgcebind is a placeholder to include additional dependencies into go.mod.
fpcli
fpcli is a helper CLI for FP-related tooling
 fpcli is a helper CLI for FP-related tooling
fpcli/cmd
Package cmd implements fpcli
 Package cmd implements fpcli
internal/fpciutil
Package fpciutil contains filepath related utilities for featureprofiles CI.
 Package fpciutil contains filepath related utilities for featureprofiles CI.
internal/mdocspec
Package mdocspec parses yaml OC requirements from functional test READMEs.
 Package mdocspec parses yaml OC requirements from functional test READMEs.
internal/ocpaths
Package ocpaths contains utilities and types for validating a set of OCPaths specified by ocpaths.proto.
 Package ocpaths contains utilities and types for validating a set of OCPaths specified by ocpaths.proto.
internal/ocrpcs
Package ocrpcs contains utilities related to ocrpcs.proto.
 Package ocrpcs contains utilities related to ocrpcs.proto.
lint2annotation
The lint2annotation command converts Go analysis Diagnostic messages into GitHub annotations.
 The lint2annotation command converts Go analysis Diagnostic messages into GitHub annotations.
nosimage/example
Package main generates example textprotos of the format specified by nosimage.proto.
 Package main generates example textprotos of the format specified by nosimage.proto.
nosimage/validate
Package main validates textprotos of the format specified by nosimage.proto.
 Package main validates textprotos of the format specified by nosimage.proto.
sort_testregistry
Binary sort_registry sorts the test registry lexically such that it is easier for humans to add to the file and find the next available ID.
 Binary sort_registry sorts the test registry lexically such that it is easier for humans to add to the file and find the next available ID.
validate_readme_spec
Command validate_readme_spec validates Paths and RPCs listed by MarkDown (READMEs) against the most recent repository states in github.com/openconfig.
 Command validate_readme_spec validates Paths and RPCs listed by MarkDown (READMEs) against the most recent repository states in github.com/openconfig.
wikidoc
wikidoc inspects all feature profiles for test plans and compiles into a single location
 wikidoc inspects all feature profiles for test plans and compiles into a single location
topologies
binding
Package binding implements a simple binding that can work with a specific hardware configuration without a reservation system.
 Package binding implements a simple binding that can work with a specific hardware configuration without a reservation system.
proto/binding

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.