# slices

**Repository Path**: openkylin/slices

## Basic Information

- **Project Name**: slices
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

中文 | [English](README.en.md)

# Slices

#### 介绍
这里保存着openKylin官方软件的slice定义文件（Slice Definition File， SDF）源码, 用于[splitter](https://gitee.com/openkylin/splitter)生成构建distroless容器镜像的slices。

#### Slices
每个openKylin版本的slice由不同的分支承载，且分支以对应的openKylin版本命名。当前官方支持的slice如下：
- [`openKylin-2.0`](https://gitee.com/openkylin/slices/tree/openKylin-2.0/)

#### Slice 描述文件
Slice 描述文件定义了openKylin软件包切分成不同slice的规则，软件包`A`的 Slice 描述文件格式如下：
```
# A.yaml
package: A

deps:
  - A_copyright

slices:
  slice1:
    deps:
      - B_slice1
  slice2:
    deps:
      - C_slice2
    contents:
      common:
        - /path/to/content1
        - /path/to/content2
        - /path/to/content3
      extra:
        linux-riscv64:
          - /path/to/content4
        copy:
          - /path/to/content5: /outside/path/to/content5
        ...
  copyright:
    contents:
      common:
        - /path/to/content6
```

Slice 描述文件的文件名为`{package}.yaml`, `{package}`是软件包名，内容如下：
- `package`: 软件包，与文件名对应
- `deps`: 依赖的slice
- `slices`: 所有的slice
- `contents`: 每个slice包含的文件，其中：
    - `common`: slice包含的基础文件范围
    - `extra`: slice依赖的从软件包外部引入或不同架构定制的内容
- `copyright`: 软件lisence


#### 如何使用
slices与[splitter](https://gitee.com/openkylin/splitter)一起使用。在使用splitter切分软件包生成slice时，用户必须指定通过`--release`指定slice。

#### 参与贡献
欢迎广大开发者参与openKylin distroless镜像生态建设！

1. 请提issue描述对更多distroless镜像的需求，并与社区讨论、开发相关 Slice 描述文件
2. 对distroless容器构建有更优的实现，请提PR至[splitter](https://gitee.com/openkylin/splitter)仓库