Before you can install resources with pragma-os, you need:
- A Pragmatiks account
- A GCP project with the necessary APIs enabled
- Credentials configured for GCP access
Create a Pragmatiks Account
Sign up at pragmatiks.io. You can use Google, GitHub, or email to create your account.
After signing up, verify your account is active:
pragma auth login
pragma auth whoami
GCP Project Requirements
pragma-os provisions resources in your GCP project. You need:
- A GCP project with billing enabled
- Owner or Editor role on the project (or specific IAM roles for the resources you want to use)
Required APIs
Enable the following APIs in your GCP project:
| API | Purpose |
|---|
| Cloud Resource Manager | Project metadata |
| Cloud Storage | Storage bucket resources |
| BigQuery | Dataset and table resources |
| IAM | Service account resources |
gcloud services enable cloudresourcemanager.googleapis.com \
storage.googleapis.com \
bigquery.googleapis.com \
iam.googleapis.com \
--project=YOUR_PROJECT_ID
Option 1: Application Default Credentials (Recommended)
Use your personal Google account credentials. This is the simplest approach for local development.
gcloud auth application-default login
gcloud auth application-default print-access-token
Option 2: Service Account
For production or CI/CD environments, use a service account key.
- Create a service account in your GCP project
- Grant it the necessary roles (e.g., Storage Admin, BigQuery Admin)
- Download a JSON key file
- Set the environment variable:
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
Keep service account keys secure. Never commit them to version control.
Verify Your Setup
Run these commands to confirm everything is configured:
# Check Pragmatiks authentication
pragma auth whoami
# Check GCP project access
gcloud config get-value project
# Check GCP credentials
gcloud auth application-default print-access-token
Next Steps
