website/docs: add docs for websocket connections
Signed-off-by: Jens Langhammer <jens.langhammer@beryju.org>
This commit is contained in:
		
							
								
								
									
										23
									
								
								website/developer-docs/api/making-schema-changes.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										23
									
								
								website/developer-docs/api/making-schema-changes.md
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,23 @@
 | 
			
		||||
---
 | 
			
		||||
title: Making schema changes
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
Some backend changes might require new/different fields or remove other fields. To create a new schema after changing a Serializer, run `make gen-build`.
 | 
			
		||||
 | 
			
		||||
This will update the `schema.yml` file in the root of the repository.
 | 
			
		||||
 | 
			
		||||
## Building the Go Client
 | 
			
		||||
 | 
			
		||||
The Go client is used by the Outpost to communicate with the backend authentik server. To build the go client, run `make gen-outpost`.
 | 
			
		||||
 | 
			
		||||
The generated files are stored in `/api` in the root of the repository.
 | 
			
		||||
 | 
			
		||||
## Building the Web Client
 | 
			
		||||
 | 
			
		||||
The web client is used by the web-interface and web-FlowExecutor to communicate with authentik. To build the client, run `make gen-web`.
 | 
			
		||||
 | 
			
		||||
Since the client is normally distributed as an npm package, running `make gen-web` will overwrite the locally installed client with the newly built one.
 | 
			
		||||
 | 
			
		||||
:::warning
 | 
			
		||||
Running `npm i` in the `/web` folder after using `make gen-web` will overwrite the custom client and revert to the upstream client.
 | 
			
		||||
:::
 | 
			
		||||
		Reference in New Issue
	
	Block a user