Open-source IDP for developers and non-specialists to manage multi-instance deployments, microservices and configurations in Kubernetes & Docker.
dyrector.io is an open-source deployment platform that helps software teams manage releases & deployments easily and efficiently. While non-specialists are enabled to manage these processes in a simplified, self-service manner, specialists can deploy and manage containerized apps faster through the platform.
Our product is a platform for:
- DevOps & System Engineers can build and manage robust cloud infrastructure
- Engineers can focus more on developing the product because self-service deployments are faster
- Stakeholders can deliver new functions and products with a higher velocity
- CTOs & Technical Managers can reduce time-to-market, manage cloud costs more efficiently and maintain team productivity.
Warning dyrector.io platform is under development, please treat as such. Expect bugs here and there. Early adopters welcome.
- Kubernetes and Docker support
- Multi-instance deployment
- Instant test environments from any branches
- Environment management
- Secret and configuration management
- Auto-generated changelogs and release notes (WIP)
- Workflow support
- Scheduled releases (WIP)
- Audit log
- Container Registry integrations
- Fine-grained RBAC (WIP)
- ChatOps & notification solutions
dyrector.io consists of an agent (GoLang) and a platform (UI developed in React.js, Next.js. Backend developed in Node.js, Nest.js). There are two types of agents communicating with the platform: one for Docker and another for Kubernetes. Communication takes place in gRPC with TLS encryption. The data is managed in a PostgreSQL database which we use with Prisma ORM.
Trigger deployments of the same application to multiple environments from one place using the same or various configurations.
Both Docker and Kubernetes require specialized staff to manage. Via dyrector.io, your team’s non-specialist staff can contribute to the process, as well.
Seamless testing whenever your team wants to test the application, without waiting for a SysAdmin to set up an environment.
dyrector.io CLI, is a command-line interface that lets you run and manage the whole dyrector.io projects locally.
This means you get a full-featured dyrector.io platform running locally on your machine.
- Docker installed on your system but Podman works, too. In case of Linux, you need Docker Compose, as well.
- Go Compiler to run the CLI by its source code.
Note The CLI is only available from the codebase at the moment. Package manager installation is in the works.
- Clone the repository to your local workdir with
git clone
- Open the
/cli
folder and executego run . up
- Open the
localhost:3000
and use the platform
dyrector.io's command-line interface (CLI) lets you run a complete dyrector.io development environment locally with the following services: UI Service (crux-ui), Backend Service (crux), PostgreSQL database, Authentication, Migrations, and SMTP mail server.
Read more about the CLI in the documentation.
The easiest way to get started with the dyrector.io platform is by our premade docker-compose file.
- First you have to create
.env
from.env.example
files in your local environment, in the following folders:/web
,/web/crux
,/web/crux-ui
On Windows and Mac use host.docker.internal
in the .env
files for URLs.
- Build the dyrector.io platform dependencies, this step is only required once:
docker-compose -f web/docker-compose.dev.yaml build
- To run the dyrector.io platform dependencies:
docker-compose -f web/docker-compose.dev.yaml up
If you are having problems starting crux-kratos-migrate
change the line endings of web/kratos/entrypoint.sh
from CRLF to LF. These problems include ERROR: Encountered errors while bringing up the project.
while running docker-compose up
or ': No such file or directory
in the container log.
- Now as all the infrastructure is ready, you need to install all the node.js dependencies in the specific projects' folder. To install all (
web/crux/
,web/crux-ui/
) dependencies runnpm install
.
on Apple Silicon run npm install --target_arch=x64
- In
crux/
folder you have to migrate the database and generate the Prisma client
npx prisma generate
npx prisma migrate deploy
-
To start services run
npm start
in the followind folders/web/crux
and/web/crux-ui
-
Open the platform in
host.docker.internal:8000
and register -
In local our auth service is using a mock, so you can confirm your email in
http://localhost:4436/
-
Now you can log in and use the platform
We are planning to support a hosted version in the near future.
-
How do I get in touch with the Support Team?
You can contact dyrector.io support directly using our contact forms for users and developers or by reaching out to us via email at [email protected]. Developers can get in touch via our Community Discord server.
-
Can we use dyrector.io without containerization?
Unfortunately, we're unable to support applications that don't run in a containerization environment.
Also, follow dyrector.io on GitHub Discussions, our Blog, and on Twitter. You can chat with the team and other members on Discord.
dyrector.io is Open Source - This repository, and most of our other open source projects, are licensed under the Apache 2.0.
Join our Discord and connect with other members to share and learn together. Send a pull request to any of our open source repositories on Github. Check our contribution guide and our developers guide for more details about how to contribute. We're looking forward to your contribution!
The project can only accept contributions which are licensed under the Apache License 2.0. For further information please see our Contribution Guidelines.
Install the generator
go get -u github.com/git-chglog/git-chglog/cmd/git-chglog
Usage
git-chglog --next-tag vx.y.z -o CHANGELOG.md
git tag -a vx.y.z
git push --tags
In order to draft a new release:
- create a new release tag on develop
- generate changelogs
See CHANGELOG.md
We’d love to hear your thoughts on this project. Feel free to drop us a note!
dyrector.io is open source software under the Apache License 2.0. Complete license and copyright information can be found in the source code.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.