fitzhi/application repository overview

⁠Fitzhì© container repository

⁠What is Fitzhì ? And what for Fitzhì ?

Fitzhì aims to gather all technical data regarding your application portfolio into ONE single portal. Fitzhì provides also analysis and assessments at the project scope, but its main target is the portfolio. Our main ambition is to provide a global, and dynamic vision of the technical risk for your IT. This vision addresses both the technical and code aspects of applications and the assessment of teams.

Our main feature for Fitzhì should be the ONE single dashboard, one Single Point Point Of Quality, available for the CTO, or CIO, and ready to resume in one second, one view, the current situation and the historic trend.

Fitzhì aims to answer multiple questions such as :

• Did we technically improve our IT portfolio last year ?
• Did the actual turnover downgrade, or not, our mastery in our applications ?
• What is the code quality evaluation for the whole portfolio ?
• Can we globally assess the IT assets of this company over which we just have taken control ?
• Who are the key peoples of my organization regarding their application knowledge ?
• Which skill is lacking of Senior developer regarding the need of my applications ?
• Which percentage of your portfolio is covered by your actual IT crew ?
• How did the last audit value your application ?

⁠Installation

The application contains one java-spring backend server, and one Angular frontend. This application can be linked with a Sonar instance. This is not mandatory. Sonar is considered as one the sources of quality for Fitzhì, but not the only one.

Fitzhi data should be kept outside the container. Therefore you should create a volume on your host.

docker volume create fitzhi-data

To run the application just type (This is the recommended way with the Sonar token login)

docker run --name fitzhi \
-e "urlSonarServer=http://yourSonarHostname:9000" \
-e "login=youLoginTokenToSonar" \
-v fitzhi-data:/fitzhi/deploy/ \
-p 80:80 -d --rm fitzhi/application:1.8

If you use the Sonar cloud service, the name of your organization can be passed

docker run --name fitzhi \
-e "organization=yourOrganization" \
-e "urlSonarServer=https://sonarcloud.io" \
-e "login=youLoginTokenToSonarCloud" \
-v fitzhi-data:/fitzhi/deploy/ \
-p 80:80 -d --rm fitzhi/application:1.8

(with the pair of connection (user/password) for Sonar)

docker run --name fitzhi \
-e "urlSonarServer=http://yourSonarHostname:9000" \
-e "user=youSonarUser" \
-e "password=yourSonarPassword" \
-v fitzhi-data:/fitzhi/deploy/ \
-p 80:80 -d --rm fitzhi/application:1.8

The application can be configured through an application.properties file available in the local storage provided to the container. A complete description of these settings are listed on the Fitzhì website⁠.

⁠Authentication settings

Fitzhì authentication supports also the OpenId protocol. The configuration is stored in the file openid-servers.json. The content below displays the sample settings linked with localhost. You can declare your own Fitzhi instance with Google and/or Github (https://developers.google.com/identity/protocols/oauth2/openid-connect⁠, https://docs.github.com/en/developers/apps/building-oauth-apps⁠).

[
	{ 
		"serverId": "GOOGLE", 
		"clientId": "18829978963-01qskld67kq2ohpo7ra4p8ct2ji9hevj.apps.googleusercontent.com"
	},
	{ 
		"serverId": "GITHUB", 
		"clientId": "2f4e316a896a6cbb3f2c",
		"clientSecret": "e0a2f0867cc4bb621e16b777019a731601b04b5c"
	}
]

To inject this configuration setting, you just can type

docker cp /your/local/path/to/openid-servers.json fitzhi:/fitzhi/deploy/data/referential/openid-servers.json
docker stop fitzhi
docker run ...