github/kata-containers
1
0
Fork 2
mirror of https://github.com/kata-containers/kata-containers.git synced 2025-09-14 05:19:21 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #6753 from amshinde/add-cross-building-with-cross

Browse Source 
cross-compile: Include documentation and configuration for cross-compile
This commit is contained in:
Tim Zhang
2023-05-09 16:31:40 +08:00
committed by GitHub
parent 4e0dce6802 8495f830b7
commit b0b5d7082e
2 changed files with 43 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
src/tools/kata-ctl/Cross.toml Normal file
View File

@@ -0,0 +1,12 @@
[target.s390x-unknown-linux-gnu]
pre-build = ["dpkg --add-architecture s390x && apt-get update && apt-get install -y libssl-dev:s390x"]
[target.aarch64-unknown-linux-musl]
pre-build = ["dpkg --add-architecture arm64 && apt-get update && apt-get install -y libssl-dev:arm64"]
[target.x86-64-unknown-linux-musl]
pre-build = ["dpkg --add-architecture amd64 && apt-get update && apt-get install -y libssl-dev:amd64"]
# Powerpc compile seems to be broken, due to `ring` crate not being supported on powerpc.
[target.powerpc64le-unknown-linux-gnu]
pre-build = ["dpkg --add-architecture ppc64le && apt-get update && apt-get install -y libssl-dev:ppc64le"]

31
src/tools/kata-ctl/README.md
View File

@@ -47,3 +47,34 @@ For a usage statement, run:
```bash
$ kata-ctl --help
```
## Cross-builds
For developers that want to build and test the `kata-ctl` tool on various architectures,
the makefile included does have support for that. This would however, require installing
the cross compile toolchain for the target architecture on the host along with required libraries.
[Cross](https://github.com/cross-rs/cross) is an open source tool that offers zero setup
cross compile and requires no changes to the system installation for cross-compiling
rust binaries. It makes use of docker containers for cross-compilation.
You can install cross with:
```
cargo install -f cross
```
`cross` relies on `docker` or `podman`. For dependencies take a look at: https://github.com/cross-rs/cross#dependencies
There is an included `cross` configuration file [Cross.yaml](./Cross.toml) that can be used
to compile `kata-ctl` for various targets. This configuration helps install required
dependencies inside a docker container.
For example, to compile for target `s390x-unknown-linux-gnu` included in `Cross.yaml` simple run:
```
cross build --target=s390x-unknown-linux-gnu
```
You may also need to add the target on your host system prior to the above step as:
```
rustup target add s390x-unknown-linux-gnu
```