Skip to content

Commit 0121af1

Browse files
fix: release.yaml
1 parent dc80967 commit 0121af1

File tree

4 files changed

+88
-14
lines changed

4 files changed

+88
-14
lines changed

.github/workflows/release.yml

+4
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,10 @@ jobs:
8181
- run: git fetch --force --tags
8282
- name: Initialize and update submodules
8383
run: git submodule update --init --recursive
84+
- name: List Nested Directories
85+
run: |
86+
# List all nested directories
87+
find . -type f
8488
- uses: actions/setup-go@v4
8589
with:
8690
go-version: 1.21

.goreleaser.yaml

+10
Original file line numberDiff line numberDiff line change
@@ -88,3 +88,13 @@ nfpms:
8888
formats:
8989
- rpm
9090
- deb
91+
92+
files:
93+
# Include specific files or directories from submodules
94+
- templates/compage-template-go/**
95+
- templates/compage-template-java/**
96+
- templates/compage-template-javascript/**
97+
- templates/compage-template-python/**
98+
- templates/compage-template-typescript/**
99+
- templates/compage-template-rust/**
100+
- templates/compage-template-ruby/**

README.md

+73-14
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,8 @@ IoT and edge services, K8s controllers, K8s CRDs, K8s custom APIs, K8s Operators
3131
by automatically applying best practice methods like software supply chain security measures, SBOM, openAPI,
3232
cloud-events, vulnerability reports, etc. Auto generate code after defining requirements in UI as architecture diagram.
3333

34-
**Specify the requirements for backend workloads in the yaml file, and then auto-generate code, customize it and maintain it.**
34+
**Specify the requirements for backend workloads in the yaml file, and then auto-generate code, customize it and
35+
maintain it.**
3536
> Our goal is to support both auto-generate code and import existing code. Let's see how far we can go with importing
3637
> existing code support. One step at a time!
3738
@@ -91,6 +92,7 @@ Solution: **Compage**
9192
-------------------------
9293

9394
#### Current features in compage
95+
9496
- An opensource tool that runs on your local cluster (mostly a local cluster running on developer's machine), helps to
9597
visually develop backend workloads for cloud-native & K8s.
9698
- Easy to adopt & use.
@@ -104,7 +106,7 @@ Solution: **Compage**
104106

105107
#### Languages supported:
106108

107-
> OpenApi Generator based templates (REST)
109+
> OpenApi Generator-based templates (REST)
108110
109111
- GoLang
110112
- Java
@@ -123,23 +125,80 @@ contribution.
123125

124126
#### How to use Compage?
125127

126-
- A user can download the compage executable binary from releases page suitable for the user's machine architecture. The user can even build the binary from source code.
127-
- Once the binary is downloaded, user can create a yaml file as configuration to be supplied to compage binary. The yaml file can be created by running the command `compage init` and then user can edit the yaml file to add the required configuration.
128+
- A user can download the compage executable binary from releases page suitable for the user's machine architecture. The
129+
user can even build the binary from source code.
130+
- Once the binary is downloaded, user can create a yaml file as configuration to be supplied to compage binary. The yaml
131+
file can be created by running the command `compage init` and then user can edit the yaml file to add the required
132+
configuration.
133+
134+
### Getting Started
135+
136+
To use Compage:
137+
138+
- Download the `compage` binary for your platform from the
139+
official [release page](https://github.com/intelops/compage/releases).
140+
141+
#### Verifying Binary Signatures
142+
143+
Compage's release process signs binaries using Cosign's keyless signing mode.
144+
To verify a specific binary, retrieve the release checksum, signature, and public certificate for your desired `TAG`.
145+
Detailed instructions are available in the [Sigstore blog](https://blog.sigstore.dev/cosign-2-0-released/).
146+
147+
```shell
148+
# Example commands to verify a binary
149+
$ wget https://github.com/intelops/compage/releases/download/v2.0.0-beta/checksums.txt
150+
$ wget https://github.com/intelops/compage/releases/download/v2.0.0-beta/checksums.txt.pem
151+
$ wget https://github.com/intelops/compage/releases/download/v2.0.0-beta/checksums.txt.sig
152+
153+
cosign verify-blob \
154+
--certificate-identity "https://github.com/intelops/compage/.github/workflows/release.yml@refs/tags/v2.0.0-beta" \
155+
--certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
156+
--cert ./checksums.txt.pem \
157+
--signature ./checksums.txt.sig \
158+
./checksums.txt
159+
```
160+
161+
If verification is successful, you'll see "**Verified OK.**"
162+
163+
#### Installation
164+
165+
- Download the compage binary from the official [release page](https://github.com/intelops/compage/releases)
166+
- Move the executable to your `PATH` for convenience.
167+
168+
#### Quick Start
169+
170+
For a quick start, run the following command to generate a sample project:
171+
172+
```shell
173+
compage init
174+
compage generate
175+
```
176+
177+
#### Building from Source
178+
179+
The easiest way to build the `compage` executable is using
128180

129-
#### Build from source code
130181
```shell
131-
## clone the repo
132-
git clone https://github.com/intelops/compage.git
133-
## change directory to compage
134-
cd compage
135182
go build -o compage .
136-
## initialize the config.yaml file
137-
./compage init --serverType grpc
138-
## edit the config.yaml file as per your requirement
139-
## generate the code. Below command accepts serverType [rest, grpc and rest-grpc]
140-
./compage generate
141183
```
142184

185+
This will build the binary from source and place the `compage` binary in the current folder.
186+
187+
To build compage from source:
188+
189+
- Clone the compage repository: `git clone https://github.com/intelops/compage.git`
190+
- Navigate to the project directory: `cd compage`
191+
- Build compage: `CGO_ENABLED=0 go build -o compage .`
192+
193+
The generated binary - compage will be available in the current working directory. You can move it to your PATH or use it
194+
from the current directory.
195+
196+
The `init` command of the compage has a serverType argument which can be used to generate the code for the serverType:
197+
198+
- `rest` for Rest API
199+
- `grpc` for gRPC
200+
- `rest-grpc` for Rest API and gRPC
201+
143202
## Contributing
144203

145204
You are warmly welcome to contribute to Compage.

cmd/init.go

+1
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,7 @@ func createOrUpdateDefaultConfigFile() {
7979
}
8080
err = executor.Execute(filePaths, data)
8181
cobra.CheckErr(err)
82+
log.Infof("config file created at %s", configFilePath)
8283
}
8384

8485
func init() {

0 commit comments

Comments
 (0)