Drafted updates to dockerized-setup.rst

docs/source/confluence/dockerized-setup.rst

@@ -20,8 +20,8 @@ Initial Setup
 .. code-block:: sh
 
     make clean
-    docker build -t brooks.aoc.nrao.edu:5000/ssa-docker/workspaces/base:local -f Dockerfile.base .
-    docker build -t brooks.aoc.nrao.edu:5000/ssa-docker/workspaces/cache:local -f Dockerfile.cache . --build-arg BASE_IMAGE_TAG=local --build-arg BASE_REGISTRY_URL="brooks.aoc.nrao.edu:5000/ssa-docker/workspaces"
+    docker build -t ssa-containers.aoc.nrao.edu:5000/ssa-docker/workspaces/base:local -f Dockerfile.base .
+    docker build -t ssa-containers.aoc.nrao.edu:5000/ssa-docker/workspaces/cache:local -f Dockerfile.cache . --build-arg BASE_IMAGE_TAG=local --build-arg BASE_REGISTRY_URL="ssa-containers.aoc.nrao.edu:5000/ssa-docker/workspaces"
     docker compose -f docker-compose.yml -f docker-compose.local.yml up -e TAG=local
 
 This will build your local development images and containers
@@ -33,6 +33,77 @@ Note: If you notice 'no such file or directory' errors with the docker compose c
 3. Run ``make reallyclean``
 4. Run ``make build`` again, followed by the docker compose command previously mentioned.
 
+If you notice an error like `Failed to stat ~/.ssh/id_rsa: no such file or directory` with the docker compose command, try the following:
+
+1. Cancel the docker compose command
+2. Make a dummy file at `~/.ssh/id_rsa`
+3. Try the next set of steps
+
+If you notice an error like `fatal: could not read from remote repository` with the docker compose command, try the following steps:
+
+1. Apply the following patch to `config/htcondor/execute/Dockerfile.local`:
+
+.. code-block:: diff
+
+   --- a/config/htcondor/execute/Dockerfile.local
+   +++ b/config/htcondor/execute/Dockerfile.local
+   @@ -1,8 +1,6 @@
+    # Condor execute node image
+    FROM htcondor/execute:9.0.6-el7
+
+   -RUN yum install -y git
+   -
+    # Create vlapipe group
+    RUN groupadd --gid 6000 vlapipe && \
+    # Create vlapipe user placed in vlapipe group
+   @@ -20,19 +18,7 @@ COPY docker.properties /home/casa/capo/docker.properties
+
+    ENV CAPO_PROFILE "docker"
+
+   -# Add gitlab as a known SSH host
+   -RUN mkdir -p ~/.ssh && \
+   -    chmod 0700 ~/.ssh && \
+   -    ssh-keyscan gitlab.nrao.edu > ~/.ssh/known_hosts
+   -
+   -# Link to the host's SSH key and clone over SSH (non-public repo)
+   -RUN --mount=type=secret,id=host_ssh_key,required \
+   -    ln -s /run/secrets/host_ssh_key ~/.ssh/id_rsa \
+   -    && git clone --depth=1 gitlab@gitlab.nrao.edu:scg/condor_transfer_plugin.git \
+   -    && cp condor_transfer_plugin/nraorsync_plugin.py /usr/libexec/condor/
+   -
+   -# Remove SSH stuff
+   -RUN rm -rf ~/.ssh/
+   +COPY ./condor_transfer_plugin/nraorsync_plugin.py /usr/libexec/condor/
+
+    # Apply config within the container
+    RUN ./update-config
+
+2. Run `git clone --depth=1 gitlab@gitlab.nrao.edu:scg/condor_transfer_plugin.git` in `workspaces/`
+3. Try the above docker compose command again
+
+Once the docker compose stack comes up successfully, do the following to allow worklows to execute:
+
+1. `ssh-keygen ~/.ssh/condor_transfer`
+2. `cd workspaces/lustre/aoc/cluster/pipeline/docker/workspaces/sbin/`
+2. `touch curator`
+3. `touch ingest`
+3. `touch productfetcher`
+4. Kill and re-run the above docker compose command
+
+Now you should have Workspaces running on your local machine!
+You can access the frontend in your browser at localhost:4444 and the database at localhost:54322.
+
+It comes with some sample data to facilitate testing.
+For instance, to run a calibration workflow from the form on `http://localhost:4444/workspaces/active-requests`, use the following query to find suitable ngas_fileset_id's/SDM ids:
+
+.. code-block:: sql
+   select ngas_fileset_id, e.project_code, p.title, e.starttime, a.firstname, a.lastname, telescope from execution_blocks e
+   JOIN projects p on e.project_code = p.project_code
+   JOIN authors a on p.project_code = a.project_code
+   ;
+
+`source <https://gitlab.nrao.edu/ssa/workspaces/-/blob/20289da18f92609d104860d0d4fe4811e25d6363/apps/cli/utilities/aat_wrest/aat_wrest/metadata_wrester.py#L52>`_
+
 Running Different Docker Setups
 ~~~~~~~~~~~~~