From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7278939938131804160 X-Received: by 2002:a2e:9b55:0:b0:2bc:e1a3:fbaa with SMTP id o21-20020a2e9b55000000b002bce1a3fbaamr1418443ljj.22.1695192873080; Tue, 19 Sep 2023 23:54:33 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a2e:a787:0:b0:2bc:e36a:9e4a with SMTP id c7-20020a2ea787000000b002bce36a9e4als3754525ljf.2.-pod-prod-03-eu; Tue, 19 Sep 2023 23:54:31 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFMg4VuLZw8r6FQUTaKf6q96Yo2fRAOMTXNOaVuSWLTYd9XpBFr86MfWvACqafcTNZRLnBt X-Received: by 2002:a2e:7807:0:b0:2bc:e470:1412 with SMTP id t7-20020a2e7807000000b002bce4701412mr1294503ljc.43.1695192870929; Tue, 19 Sep 2023 23:54:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1695192870; cv=none; d=google.com; s=arc-20160816; b=nuLBYu3xNuDhN48eQdew+k2rB8qcOX+p9VuA6Vt39NTcIapB0YhqXXJrp0El5CTTFB YopTFJz+2AK8THZpcsuD26mhBlMYpZB1HGqawT/7gRLi7iHKLJ6viwDVXHxsVv7PcfT1 8jKAC/7RDGU99YiA947r1AIB+66M16KCZDWi7N12W9ufhZ84fjFRgswMihmsnMUKkFF+ iMOhKtKTJOFdtF1nadcGIX3NTRBOWkwrkVDkR7dxrqhhqPzUJxzMuL72ytjpa8QkyOda jwTiFCCbHzs1QPi/ZR8HS0uirUZD0F8BxPVJxTzuxof39zNmOi3LRbrJ3PrnYsN/wvky lirA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from; bh=SXm3oMYf8bYm6JrnmIQpFbIRwgvOsuXPdg1O2c+IXsM=; fh=7tclEdh7YbwSQowgJ6LNq720O7H5HTEaqj22NJWRE2E=; b=dRLbfGeHlOvtA62KhpD7wDRY/daRKPHPoS3yqw1VF4AaG6mSzuP3AHxuSgtwY0vloW 2+YnDOhzQ83vIWCHmdjLGjbmpR3l6UcR9XO5pOJmWumeD2BdyGj9GxSdC85bxPT0LHSc hbKKT/fNXj7iZXgEiSh3orgJ8P/dpcRV/LrYkJgFACc18n/PqEMBw2wndnBNeEu/HVCL t0Ia6PXilQ+56W7UoqQ+v/NjrBK6/kp26EThWVlYeiB3j2Fe3fRiGEg+PQsXw11oX6Vm ggR+tGjVa023mM5mKoDuduFJc4tseuedywy7JCvWE0ICRTiU6OTp8frNn5Y/Hb+3/ZYn 8H0g== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id by44-20020a05651c1a2c00b002b9d5a29ef7si1049953ljb.4.2023.09.19.23.54.30 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Tue, 19 Sep 2023 23:54:30 -0700 (PDT) Received-SPF: pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Received: from baighyz.m.ilbers.de (host-80-81-17-52.static.customer.m-online.net [80.81.17.52]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPSA id 38K6sL1J019812 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 20 Sep 2023 08:54:29 +0200 From: Uladzimir Bely To: isar-users@googlegroups.com Subject: [PATCH v3 12/12] kas: Add kas/README.md Date: Wed, 20 Sep 2023 08:54:20 +0200 Message-Id: <20230920065420.11399-13-ubely@ilbers.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20230920065420.11399-1-ubely@ilbers.de> References: <20230920065420.11399-1-ubely@ilbers.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-TUID: VOr/kWHorlkD Add a brief description of `kas-container` usage. Signed-off-by: Uladzimir Bely --- README.md | 3 +++ kas/README.md | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 39 insertions(+) create mode 100644 kas/README.md diff --git a/README.md b/README.md index 118acf52..f549aa9f 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,9 @@ https://github.com/ilbers/isar/ Instruction on how to build can be found in the [User Manual](doc/user_manual.md). +For beginners, it could be easier to use kas-based approach that allows to +simply configure and run build using menu. Look at [kas/README](kas/README.md) +for the instructions. # Try diff --git a/kas/README.md b/kas/README.md new file mode 100644 index 00000000..d821f0c8 --- /dev/null +++ b/kas/README.md @@ -0,0 +1,36 @@ +# Support of kas + +[kas](https://github.com/siemens/kas) is a tool to setup bitbake based projects. + +Directory `kas` contains required configuration fragments to setup and build +Isar with `kas-container` script and Kconfig language. + +## Requirements + +Since kas uses Docker or Podman based containers, users that runs Isar build +using `kas-container` script should be allowed to run these containers in +privileged mode. + +## Configuring Isar build + +``` +./kas/kas-container menu +``` + +This creates `.config.yaml` file in isar root that stores the configuration. + + +## Building Isar after configuration done + +``` +./kas/kas-container build +``` + +This generates `build/conf/` configuration and starts building Isar using +kas container. Required image will be downloaded if not yet). + +To access bulid shell, the following command can be used: + +``` +./kas/kas-container shell +``` -- 2.20.1