If you want to setup our Pull Request integration, please follow this section. If you need instead to setup auth with GitHub, scroll to the Auth section below
If you use GitHub, the best way to benefit from our integration is to set-up an app:
- Please follow the instructions here to setup your GitHub App
- Then configure the below values in your
helm-config.yaml
# helm-values.yml
secret:
name: 'cloudsecret'
nxCloudMongoServerEndpoint: 'NX_CLOUD_MONGO_SERVER_ENDPOINT'
adminPassword: 'ADMIN_PASSWORD'
# define them here
githubAppId: 'NX_CLOUD_GITHUB_APP_ID'
githubPrivateKey: 'NX_CLOUD_GITHUB_PRIVATE_KEY'
githubWebhookSecret: 'NX_CLOUD_GITHUB_WEBHOOK_SECRET'
githubAppClientId: 'NX_CLOUD_GITHUB_APP_CLIENT_ID'
githubAppClientSecret: 'NX_CLOUD_GITHUB_APP_CLIENT_SECRET'
# secret.yaml
apiVersion: v1
kind: Secret
metadata:
name: cloudsecret
type: Opaque
stringData:
NX_CLOUD_MONGO_SERVER_ENDPOINT: '....'
ADMIN_PASSWORD: '....'
NX_CLOUD_GITHUB_APP_ID: '<from the values in step 1>'
NX_CLOUD_GITHUB_PRIVATE_KEY: '<from the values in step 1>'
NX_CLOUD_GITHUB_WEBHOOK_SECRET: '<from the values in step 1>'
NX_CLOUD_GITHUB_APP_CLIENT_ID: '<from the values in step 1>'
NX_CLOUD_GITHUB_APP_CLIENT_SECRET: '<from the values in step 1>'
- Finally, proceed to your NxCloud web app (and your workspace Settings screen) and finish the setup there
To use GitHub for user authentication, you will need two values: GITHUB_AUTH_CLIENT_ID
and GITHUB_AUTH_CLIENT_SECRET
. Read here on how to get
those values.
Then update your helm-values.yaml
and secrets.yaml
:
# helm-values.yml
github:
auth:
enabled: true
secret:
name: 'cloudsecret'
nxCloudMongoServerEndpoint: 'NX_CLOUD_MONGO_SERVER_ENDPOINT'
adminPassword: 'ADMIN_PASSWORD'
# define them here
githubAuthClientId: 'GITHUB_AUTH_CLIENT_ID'
githubAuthClientSecret: 'GITHUB_AUTH_CLIENT_SECRET'
# secret.yaml
apiVersion: v1
kind: Secret
metadata:
name: cloudsecret
type: Opaque
stringData:
NX_CLOUD_MONGO_SERVER_ENDPOINT: '....'
ADMIN_PASSWORD: '....'
GITHUB_AUTH_CLIENT_ID: '<from the values above>'
GITHUB_AUTH_CLIENT_SECRET: '<from the values above>'
To use GitHub for user authentication, you will need two values: GITLAB_APP_ID
and GITLAB_APP_SECRET
. Read here on how to get
those values.
Then update your helm-values.yaml
and secrets.yaml
:
# helm-values.yml
gitlab:
auth:
enabled: true
secret:
name: 'cloudsecret'
nxCloudMongoServerEndpoint: 'NX_CLOUD_MONGO_SERVER_ENDPOINT'
adminPassword: 'ADMIN_PASSWORD'
# define them here
gitlabAppId: 'GITLAB_APP_ID'
gitlabAppSecret: 'GITLAB_APP_SECRET'
# secret.yaml
apiVersion: v1
kind: Secret
metadata:
name: cloudsecret
type: Opaque
stringData:
NX_CLOUD_MONGO_SERVER_ENDPOINT: '....'
ADMIN_PASSWORD: '....'
GITLAB_APP_ID: '<from the values above>'
GITLAB_APP_SECRET: '<from the values above>'
To use GitHub for user authentication, you will need two values: BITBUCKET_APP_ID
and BITBUCKET_APP_SECRET
. Read here on how to get
those values.
Then update your helm-values.yaml
and secrets.yaml
:
# helm-values.yml
bitbucket:
auth:
enabled: true
secret:
name: 'cloudsecret'
nxCloudMongoServerEndpoint: 'NX_CLOUD_MONGO_SERVER_ENDPOINT'
adminPassword: 'ADMIN_PASSWORD'
# define them here
bitbucketAppId: 'BITBUCKET_APP_ID'
bitbucketAppSecret: 'BITBUCKET_APP_SECRET'
# secret.yaml
apiVersion: v1
kind: Secret
metadata:
name: cloudsecret
type: Opaque
stringData:
NX_CLOUD_MONGO_SERVER_ENDPOINT: '....'
ADMIN_PASSWORD: '....'
BITBUCKET_APP_ID: '<from the values above>'
BITBUCKET_APP_SECRET: '<from the values above>'
To use SAML for user authentication, you will need two values: SAML_ENTRY_POINT
and SAML_CERT
. Read here on how to get
those values.
Then update your helm-values.yaml
and secrets.yaml
:
# helm-values.yml
saml:
enabled: true
secret:
name: 'cloudsecret'
nxCloudMongoServerEndpoint: 'NX_CLOUD_MONGO_SERVER_ENDPOINT'
adminPassword: 'ADMIN_PASSWORD'
# define them here
samlEntryPoint: 'SAML_ENTRY_POINT'
samlCert: 'SAML_CERT'
# secret.yaml
apiVersion: v1
kind: Secret
metadata:
name: cloudsecret
type: Opaque
stringData:
NX_CLOUD_MONGO_SERVER_ENDPOINT: '....'
ADMIN_PASSWORD: '....'
SAML_ENTRY_POINT: '<from the values above>'
SAML_CERT: '<from the values above>'