https://github.com/blackducksoftware/synopsysctl
Cloud native tool to deploy Synopsys applications in Kubernetes and OpenShift
https://github.com/blackducksoftware/synopsysctl
Last synced: 2 months ago
JSON representation
Cloud native tool to deploy Synopsys applications in Kubernetes and OpenShift
- Host: GitHub
- URL: https://github.com/blackducksoftware/synopsysctl
- Owner: blackducksoftware
- License: apache-2.0
- Created: 2020-04-14T13:59:49.000Z (about 5 years ago)
- Default Branch: develop
- Last Pushed: 2023-05-22T07:29:35.000Z (almost 2 years ago)
- Last Synced: 2024-09-18T09:31:06.615Z (7 months ago)
- Language: Go
- Size: 85.1 MB
- Stars: 8
- Watchers: 5
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# synopsysctl
Cloud native tool to deploy Synopsys applications in Kubernetes and OpenShift
## Versioning Format: SemVer
Synopsysctl follows SemVer versioning ( **major** . **minor** . **patch** )
**major**: Changes to the interface
* New flags or commands
* Support for new products
**minor**: Changes that can be supported by the current major version
* Product uses Deployments instead of ReplicationControllers; Environs are stored in different Secrets; etc.
**patch**: Bug fixes
* Clean up a bad error message
* Fixing bug in product functionality
## Quickstart
Prereqs: assuming you have tls.crt and tls.key files, just run:
```
NS=bd
kubectl create ns $NS
cd cmd/synopsysctl
SEAL_KEY=01234567890123456789012345678901
ADMIN_PASSWORD=abc123
USER_PASSWORD=qrstuv
go run main.go create blackduck $NS \
--namespace $NS \
--expose-ui loadbalancer \
--admin-password $ADMIN_PASSWORD \
--user-password $USER_PASSWORD \
--seal-key $SEAL_KEY \
--certificate-file-path tls.crt \
--certificate-key-file-path tls.key \
--verbose-level trace \
--size 10sph
```
This will take a few minutes, so please be patient and watch `kubectl get pods -A`!
### Using Blackduck
*Option 1*: port-forwarding
```
# kubectl get pods -n bd
# choose the webserver pod
kubectl -n bd port-forward bd-blackduck-webserver-7fdd87854c-chqjv 1111:8443
# go to https://localhost:1111 in your web browser
```
*Option 2*: expose a service
```
kubectl expose svc -n bd bd-blackduck-webserver --type LoadBalancer --name webserver-exposed-443-8443 --port 443 --target-port 8443
# access the external-ip at https://EXTERNAL_IP
kubectl get svc -n bd webserver-exposed-443-8443
```
### Upgrade to 2021.8.1 and above using native command
For customers using native command to deploy Black Duck, when upgrading Black Duck from version 2021.6.x to version 2021.8.1 and above, you must delete the webui service before performing a helm upgrade. This can be done by running the following commands:
```
kubectl -n delete deployment -blackduck-webui
kubectl -n delete service -blackduck-webui
```
### Upgrade to 2022.4.0 and above
Black Duck version 2022.4.0 introduces new resource guidance. Synopsysctl 3.0.1 and above must be used, when upgrading Black Duck to version 2022.4.0 and above.